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本 书 详细 曾 述 了 与 Spring Boot 2.0 相关 的 基本 解决 方案 ， 主 要 包括 定制 auto-configuration. Spring CLI 
和 Actuator, Spring Cloud 和 配置 操作 、Spring Cloud Netflix 和 Service Discovery. 构建 Spring Boot RESTful 
微服 务 、 利 用 Netflix Zuul 创建 API 网 关 、 利 用 Feign 客户 端 简化 HITPAPI、 构 建 事件 驱动 和 异步 响应 式 
系统 、 利 用 Hystrix 和 Turbine 构建 弹性 系统 、 测 试 Spring Boot 应 用 程序 、 微 服务 的 容 右 化 、API EHA, 
云 部 署 (AWS)、 生 产 服务 监视 和 最 佳 实践 等 内 容 。 此 外 ， 本 书 还 提供 了 相应 的 示例 、 代 码 ， 以 帮助 读者 
进一步 理解 相关 方案 的 实现 过 程 。 

本 书 适合 作为 局 等 院 校 计算 机 及 相关 专业 的 教材 和 教学 参考 书 , 也 可 作为 相关 开 友 人员 的 日 学 教材 和 
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译 者 m 


Spring Boot 是 市 场 上 开发 Web、 企 业 和 云 软件 的 最 住 工具 之 一 。Spring Boot 通过 减少 
样板 代码 的 数量 ， 所 供 了 现成 的 特性 和 简单 的 部 署 模型， 从 而 大 大 人 简化 了 复杂 软件 的 构建 
过 程 。 

本 书 将 解决 与 Spring Boot 2.0 强大 的 可 配置 性 和 灵活 性 相关 的 应 用 程序 设计 问题 。 读 
者 将 了 解 Spring Boot 2.0 配置 如 何在 后 台 工 作 、 如 何 敌 兰 默 认 配 置 ， 以 及 如 何 使 用 高 级 技 
术 将 Spring Boot 2.0 应 用 程序 投入 至 实际 应 用 中 。 此 外 ， 本 书 还 将 同 读者 介绍 Spring 生态 
系统 中 相对 较 新 的 主题 一 一 啊 应 式 编 程 . 在 阅读 完 本 书后 , 读者 将 精通 于 构建 和 部 著 Spring 
Boot 2.0 应 用 程序 。 同 时 ， 本 书 还 提供 了 相应 的 示例 、 代 码 ， 以 帮助 读者 进一步 理解 相关 
方案 的 实现 过 程 。 

在 本 书 的 翻译 过 程 中 ， 除 刘璋 外 ， 张 博 、 刘 晓 雪 、 王 和 辉 、 张 华 态 、 刘 神 等 人 也 参与 了 
部 分 翻译 工作 ， 在 此 一 并 表示 感谢 。 

由 于 详 者 水 平 有 限 ， 难 免 有 路 漏 和 不 妥 之 处 ， 奶 请 广大 读者 批评 指正 。 
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Pivotal 最 近 发 布 了 Spring Boot 2.0， 以 支持 啊 应 式 编程 和 云 计 算 。Spring Boot 2.0 引入 
了 诸多 新 特性 和 增强 方案 ， 本 书 也 将 对 此 进行 逐一 介绍 。 另 外 ， 本 书 还 将 引领 读者 深入 理 
解 Spring Boot 和 云 微服 务 架构 方面 的 知识 。 

当前 ,许多 公司 已 经 将 Spring Boot 作为 企业 应 用 程序 开发 的 主要 框架 ， 对 于 采用 微服 
务 架 构 的 REST API 尤其 如 此 。 对 于 Spring Boot 来 说 , 我 们 并 不 需要 使 用 外 部 企业 服务 器 。 
本 书 旨 在 曾 述 本 地 云 应 用 程序 背后 所 采用 的 第 见 设 计 方 案 ， 以 及 如 何在 Spring Boot 2.0 的 
Spring Cloud 模块 中 对 其 予以 实现 。 其 间 ， 作 者 还 进一步 总 结 了 分 布 式 设计 日 志 记 录 机 制 
和 应 用 程序 开发 过 程 中 的 一 些 最 佳 实践 方案 。 

本 书 共 15 章 ， 涵 盖 了 从 基于 微服 务 的 云 应 用 程序 开发 到 微服 务 的 部 署 〈 使 用 虐 拟 机 
或 Docker 等 容器 ) 的 方方面面 ， 包 括 如 何 使 用 Rest 模板 、Spring Cloud Netflix Feign 实现 
微服 务 染 构 中 服务 则 的 过 信 ; 如 何 使 用 Spring Cloud Stream 和 Kafka 构建 一 个 事件 驱动 的 
弹性 系统 。 这 一 部 分 内 容 还 同 读者 展示 了 如 何 使 用 Hystrix 和 Turbine 进行 监视 。 最 后 ， 本 
书 还 将 解释 如 何 测 试 和 构建 API， 并 将 其 部 署 到 容器 《如 Docker) 以 及 云 中 (如 AWS) 。 


适用 读者 


本 书 适用 于 各 种 层次 的 Java FEA R, 他 们 希望 学 习 Spring Boot 和 Spring Cloud 并 将 
其 作为 基于 企业 分 布 式 云 的 应 用 程序 。 因 此 ， 当 采用 基于 Spring Boot2.0 和 Spring Cloud 
的 微服 务 架构 时 ， 本 书 对 企业 级 Java 和 Spring 开发 人 员 来 说 十 分 有 用 , 进而 帮助 他 们 深入 
理解 本 地 云 设 计 模 式 ， 以 及 微服 务 体 系 结构 如 何 解 决 分 布 式 应 用 程序 中 本 地 云 基 础 设施 中 
的 党 见 设 计 问 题 ， 并 可 将 本 书 中 的 示例 结合 目 己 的 项 目 加 以 使 用 。 在 阅读 本 书 之 前 ， 读 者 
应 具备 Core Java, Spring Core Framework 以 及 Spring Boot 方面 的 基础 知识 。 


本 书 内 容 
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的 茶 些 改进 措施 。 

第 2 章 前 述 了 Spring Boot 的 上 自动 配置 特性 , 同时 进一步 解释 T. UD fn AA A EJ 27 1C 
置 机 制 。 

第 3 章 通 过 多 种 方式 创建 Spring Boot 应 用 程序 ， 涉 及 Spring Boot 的 Web 接口 、STS 
IDE 以 及 Spring Boot CLI. KEIRA T Spring Boot CLI， 以 及 如 何在 机 器 设备 上 安装 
Spring Boot CLI, 并 以 此 创建 Spring Boot 应 用 程序 .另外 ,本 章 还 将 通过 Actuator 介绍 Spring 
Boot 的 生产 环境 特性 。 

第 4 章 讨论 如 何 构建 配置 服务 器 ， 并 回 客 户 端 应 用 程序 提供 Git 存储 库 中 的 一 组 配置 
文件 。 在 本 章 中 ， 读 者 将 学 习 到 与 Spring Cloud 配置 服务 相关 的 知识 ， 以 及 如 何 构 建 和 使 
用 配置 服务 。 

第 5 章 介 绍 Spring Cloud Netflix 和 基于 Eureka 的 Service Discovery. 

第 6 章 构建 一 个 RESTful 原子 微服 务 ， 该 服务 使 用 Spring Cloud 和 Spring 数据 在 内 存 
数据 库 (HSQL 或 H2) 上 执行 CRUD 操作 ， 以 使 该 服务 能 够 问 Eureka 服务 磺 进 行 服务 发 
现 注 册 。 

第 7 章 探 讨 微服 务 通信 的 API 网 天 模 了 式 ， 无论 是 来 目 UI 组 件 还 是 来 目 内 部 服务 调用 。 
另外 ， 还 将 使 用 Netflix API Zuul 实现 一 个 API 网 关 ， 并 了 解 如 何在 应 用 程序 中 设置 Zuul 
代理 。 

第 8 章 对 Feign 及 其 工作 方式 加 以 介绍 ,其 中 包含 了 针对 业务 需求 相关 的 、 详 细 的 Feign 
扩展 /定制 方式 ， 其 中 展示 了 目 定 义 编码 器、 解码 器 、Hystrix 和 单元 测试 异 第 处 理 方面 的 
参考 实现 。 

第 9 章 讲 述 了 如 何 及 用 事件 驱动 架构 并 作为 本 地 云 应 用 程序 构建 事件 驱动 型 微服 务 。 
对 于 分 布 式 系统 中 的 数据 一 致 性 处 理 ， 本 章 将 考 答 一 些 重要 的 概念 和 主题 。 

第 10 章 通 过 参考 实现 探讨 断路 器 模式 ,其 中 涉及 Netflix Hystrix 库 的 使 用 ,配置 Turbine 
仪表 盘 以 整合 来 和 目 多 项 服务 的 Hystrix fiù o 

第 11 章 通过 JUnit 和 Mockito 讨论 Spring Boot Services 单元 测试 。 其 中 ， 全 部 参考 实 
现 都 将 完成 相应 的 单元 测试 。 因 此 ， 本 章 内 容 更 多 地 是 整合 了 微服 务 的 各 种 测试 机 制 |。 

第 12 章 介 绍 容 器 ， 并 在 Docker 中 运行 第 11 章 中 构建 的 服务 、 编 写 Dockerfile、 使 用 
docker-compose 编排 容器 ， 并 在 Kubernetes 中 提供 编排 示例 。 

第 13 章 探讨 分 布 式 系统 中 的 API 管理 ,设置 KONG 开源 API 管理 器 、 在 KONG API 
EEEa PAEA A n PHI API m £D API 标准 引入 Swagger。 最 后 ， 本 章 还 将 展示 
速率 限制 以 及 基于 KONG HJ Hz iae 

第 14 章 介绍 如 何在 AWS EC2 实例 中 手动 部 著 微 服务 ， 以 及 CloudFormation 脚本 的 


应 用 方式 。 
第 15 章 详 细 介绍 构建 分 布 式 系统 的 一 些 最 佳 实践 , 并 深入 讨论 生产 环境 下 服务 的 性 能 


软件 环境 和 资源 下 载 


本 书 内 容 可 供 读 者 独立 阅读 。 但 是 ， 为 了 更 好 地 理解 书 中 的 相关 示例 ， 读 者 需要 安装 
Java 8。 对 此 ， 可 访问 http:/www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads- 
2133151.html 下 载 Java 8。 此 外 , 族 着 还 可 根据 个 人 豆 好 安 冯 相应 的 IDE, 如 Software Spring 
Tool Suite。 读 者 可 访问 https://spring.io/tools/sts/all, 并 根据 个 人 操作 系统 下 载 Spring Tool Suite 
(STS) 的 最 新 版 本 。Java8 和 STS 也 适用 于 其 他 平台 ， 如 Windows, macos 和 Linux. 
读者 可 访问 http://www.packtpub.com 并 通过 个 人 账户 下 载 示 例 代 码 文 件 。 另 外 ， 在 
http://www.packtpub.com/support 中 注册 成 功 后 ， 我 们 将 以 电子 邮件 的 方式 将 相 天 文件 友 与 
BUB e 
读者 可 根据 下 列 步 又 下 载 代 人 码 文 件 : 
(1) 利用 电子 邮件 地 址 和 密码 登录 或 注册 我 们 的 网 站 。 
(2) 选择 SUPPORT 选项 卡 。 
(3) 单 击 Code Downloads & Errata。 
(4) 在 Serach 文本 框 中 输入 书 名 。 
当 文 件 下 载 完 毕 后 ， 确 保 使 用 下 列 最 新 版 本 软件 解压 文件 炎 : 
Q | Windows 系统 下 的 WinRAR/7-Zip。 
Q Mac 系统 下 的 Zipeg/iZip/UnRarX。 
口 Linux 系统 下 的 7-Zip/PeaZip。 
AIk EAMA Y] GitHub 获取 本 书 的 代码 包 ， 对 应 网 址 为 https://github.com/ 
PacktPublishing/Mastering-Spring-Boot-2.0. 此外, TEA EAJ V E] https://github.com/PacktPublishing/ 
以 了 解 丰富 的 代码 和 视频 资源 。 


本 书 约定 


本 书 巡 过 不 同 的 文本 风格 区 分 相应 的 信息 类型 。 下 面 迪 过 一 些 示 例 对 此 类 风格 以 及 具 
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体 侣 义 的 解释 子 以 展示 。 
ARASIRA F TZR: 


@RestController 
class HelloController { 
@GetMapping ("/") 
String hello() { 
"Hello World!!!" 


} 
} 
当 某 个 代码 块 希望 引起 读者 的 足够 重视 时 ， 一 般 会 采用 黑体 表示 ， 如 下 所 示 : 
«dependencies» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-web«/artifactId» 
«/dependency» 
«/dependencies» 


命令 行 输入 或 输出 则 采用 下 列 方式 表达 : 
$ Spring run HelloController.groovy 
和 图 标 表示 较为 重要 的 说 明 事 项 。 

图 标 表示 提示 信息 和 操作 技巧 。 


读者 反馈 和 客户 文 持 
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对 此 ， 读 者 可 同 feedback(gpacktpub.com SWF. ABZAB. riu 
对 本 书 有 任何 疑问 ， 均 可 及 送 邮件 至 questions@packtpub.com， 我 们 将 竟 城 为 您 服务 。 

厂 读 者 针对 某 项 技术 具有 专家 级 的 见解 ， 抑 或 计划 撰写 书籍 或 完善 某 部 著作 的 出 版 工 
作 ， 则 可 访问 www.packtpub.com/authors。 


BI VAR 


尽管 我 们 在 最 大 程度 上 做 到 尽善尽美 ， 但 错误 依然 在 所 难免 。 如 果 读 者 发 现 座 误 之 


前 


Dli} 
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处 ， 无 论 是 文字 错误 抑或 是 代码 错误 ， 还 望 不 音 赐教 。 对 此 ， 读 者 可 访问 http://www. 
packtpub.comy/submit-errata， 选 取 对 应 书籍 ， 单 击 Errata Submission Form 超 链 接 ， 并 输入 相 
天 问题 的 详细 内 容 。 


版 权 须 知 


一 直 以 来 ， 互 联网 上 的 厂 权 问题 从 未 间断 ，Packt 出 版 社 对 此 类 问题 异 剃 重视。 大 读者 
在 互联 网 上 有 友 现 本 书 任意 形式 的 副本 ,请 告知 网 络 地 址 或 网 站 名 称 ,， 我 们 将 对 此 了 予以 处 理 。 
天 于 盗版 问题 ， 读 者 可 发 过 邮件 至 copyright(apacktpub.com. 


问题 解答 


右 谈 者 对 本 书 有 任何 疑问 ， 均 可 发 送 邮 件 全 questions@packtpub.com， 我 们 将 剖 城 为 
您 服务 。 
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众所周知 ， 无 论 对 于 核心 和 企业 级 应 用 程序 ，Spring Framework 均 可 简化 开发 流程 ， 
因而 是 一 种 十 分 流行 的 框架 。Spring 团队 不 断 地 完善 其 内 容 ， 且 专注 于 软件 开发 的 简洁 
性 。Spring 团队 在 2013 年 发 布 了 Spring Framework 的 一 个 主要 项 目 ， 即 Spring Boot. 

Spring 团队 项 目 自 在 傈 化 软件 的 开发 过 程 。Spring Boot 并 非 古 独立 的 框架 ， 而 是 构 
F Spring Framework 之 上 的 ， 二 者 加 具 有 相似 性 。Spring Boot 可 视 为 现 有 和 内容 的 集合 ， 
用 户 只 需要 加 以 选择 和 使 用 即 可 ， 且 不 希 要 任何 额外 的 配置 开销 。 

Spring 团队 仍 在 不 断 地 完善 Spring 生态 圈 ， 以 使 其 在 市 场 中 获得 更 好 的 支持 ， 其 中 
包括 云 计 算 、 大 数据 、 无 模式 数据 持久 化 和 啊 应 式 编 程 。 在 最 近 的 几 年 里 ，Spring Boot 
给 用 户 禹 来 了 诸多 最 新 的 特性 。Spring Boot 可 视 为 Spring 团队 为 Spring 框架 所 做 的 一 项 
伟大 友 明 ， 因 此 Spring 已 经 稳定 了 很 长 一 段 时 间 ， 并 局 得 了 主要 的 市 场 份额 。 

本 章 将 帮助 谈 者 理解 Spring Boot 2.0 PA — EREE, U starter project、 目 动 
配置 和 starter parent。 此 外 ， 读 者 还 将 理解 如 何 利 用 Spring Boot 简化 软件 开发 流程 ， 并 
与 读者 分 至 Spring Boot 成 功 背 后 的 一 些 故 事 。 最后， 本 章 将 利用 Spring Boot 创建 一 个 示 
例 程序 ， 并 生成 REST 服务 。 

在 阅读 完 本 章 内 容 后 ， 读 者 将 了 解 如 何 利 用 Spring Boot 实现 应 用 程序 的 敏捷 开发 ， 
并 为 创建 REST xS dep LH KE” . AIh, XIX auto-configure， 读 者 还 可 在 企 
业 级 应 用 程序 的 配置 级 别 上 利用 Spring Boot 处 理 一 些 常 见 的 问题 。 

本 章 主 要 涉及 以 下 主题 ; 

L] Spring Boot 概述 。 

D ”利用 Spring Boot fi] 45 Spring 应 用 程序 开 有 友 。 

Q Spring Boot 的 核心 组 件 。 

» Spring Boot starter project. 
»  auto-configuration. 

» Spring Boot CLI. 

» Spring Boot Actuator. 

Q ME Spring Boot 工作 区 。 

”开发 第 一 个 Spring Boot 应 用 程序 。 

D Spring Boot 2.0 中 的 新 特性 。 

下 面 将 对 此 进行 逐一 讨论 。 
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l.l Spring Boot 概述 


在 笔者 看 来 ，Spring Boot 就 像 是 一 种 等 每 进餐 的 食物 。 从 Spring 应 用 程序 开发 角 
EKE., Spring 应 用 程序 通常 需要 完成 大 量 的 设置 任务 。 假 设 读者 正 与 JPA 协同 工作 ， 
而 需要 使 用 到 DataSource、TransactionManager、EntityManagerFactory 等 ; 如 果 与 
Web MVC 应 用 程序 协同 工作 ， 则 需要 使 用 到 WebApplicationInitializer/web.xml、 
ContextLoaderListener 和 DispatcherServlet; 如 朵 读者 利用 JPA 在 MVC 应 用 程序 上 工作 ， 
则 会 涉及 上 述 全 部 内 容 。 但 此 类 内 容 在 很 大 程度 上 是 可 以 预见 的 ，Spring Boot 可 为 用 户 
完成 大 部 分 设置 工作 。 

Spring Boot 为 使 用 Spring 框架 的 应 用 程序 开发 提供 了 一 种 新 的 策略 ， 而 且 不 会 引起 
太 大 的 有 兵 烦 ,以 使 开 友 人 员 主 要 关注 于 应 用 程序 的 各 项 功能 ， 而 非 Spring 的 元 配置 问题 。 
在 Spring 应 用 程序 中 ，Spring Boot 仅 涉 及 较 少 的 配置 工作 或 零 配 置 。 

Spring Boot 文档 中 对 此 有 如 下 描述 : 

“Spring Boot 可 以 轻松 地 创建 独立 的 、 基 于 生产 级 的 Spring 应 用 程序 ， 用 户 可 以 直 
接 运 行 这 些 应 用 程序”， 


Spring Boot 调整 了 Spring 应 用 程序 的 开发 方式 。 当 查看 Spring Framework 最 初版 本 
时 ，Spring 是 一 种 轻 量 级 、 耐 同 POJO 的 框架 ， 这 意味 着 该 框架 是 解 粮 的 且 包 含 较 少 的 代 
t, FAH XML 进行 配置 。Spring 2.5 中 引入 了 注解 ， 并 通过 组 件 扫 描 方式 减少 了 XML 
配置 。Spring 3.0 Wiji f Java 配置 ， 但 需要 注意 的 是 ， 配 置 中 仍 不 包含 转 义 。 最 后 ， 在 
Spring 的 最 新 版 本 中 ， 组 件 扫 摘 机 制 减少 了 配置 内 容 ，Java 配置 则 进一步 降低 了 时 间 消 
耗 。 但 是 ，Spring 仍 会 涉及 大 量 的 配置 工作 。 

Spring 应 用 程序 中 的 这 一 类 配置 行为 已 经 影响 到 实际 业务 功能 的 开发 ,更 像 是 Spring 
应 用 程序 开发 过 程 中 引起 摩擦 的 一 个 根源 。 毫 无 疑问 ，Spring Framework 在 Java 开发 应 
用 程序 方面 为 我 们 做 了 更 多 的 工作 。 如 果 错 误 产 生 于 配置 层 ， 那 么 将 会 花费 大 量 的 时 间 
对 其 进行 调试 和 处 理 。 

引起 证 突 的 另 一 个 根源 是 项 目 依赖 关系 管理 。 添 加 依赖 关系 是 一 项 非常 楷 杂 的 工作 ， 
这 让 开 及 人 员 在 决定 哪些 库 需 要 成 为 项 目 构 建 的 一 部 分 时 感到 头痛 。 茶 些 时 候 ， 识 别 依 
赖 库 的 版 本 甚至 更 具 挑 战 性 。 

综 上 所 述 ， 配 置 工 作 、 依 赖 关 系 管理 ， 以 及 确定 依赖 库 的 版 本 占用 了 软件 工程 师 大 
量 的 研发 时 间 ; 相应 地 ， 研 发 生产 力也 随 之 降低 。 

Spring Boot 则 改变 了 这 一 切 ， 但 需要 记 住 的 是 ，Spring Boot 并 不 是 一 款 代 人 码 生 成 器 
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或 者 IDE 插件 。 

Spring Boot 对 Spring 应 用 程序 具有 目 己 的 观点 。Spring 项 目的 固有 运行 期 可 文 持 不 
同 的 项 目 类 型 ， 例 如 Web 和 批 处 理 ， 并 为 用 户 处 理 大 多 数 底层 、 可 预测 的 设置 。 

那么 ， 什 么 是 固有 的 运行 期 ? 一 般 情 况 下 ，Spring Boot 根据 类 路 径 内 容 使 用 了 一 些 
有 意义 的 默认 值 ， 即 选项 。 例 如 ， 如 果 JPA 实现 位 于 该 路 径 上 ，Spring Boot 将 配置 一 个 
JPA Entity Manager Factory; 如 果 Spring MVC 位 于 访 路 径 上 ，Spring Boot 将 使 用 默认 的 
Spring MVC 设置 。 尽 管 如 此 ， 每 项 内 容 均 可 方便 地 被 修改 一 但 大 多 数 时 候 ， 用 户 无 顷 
窗 写 任何 内 容 。 

Fifi] £r Spring Boot 如 何 简化 Spring 应 用 程序 的 开发 任务 。 


1.2 利用 Spring Boot (8) 46/9 Jf] ££ FF 7F AC 


当 配 置 Spring 应 用 程序 中 的 bean 时 ，Spring Framework 提供 了 较 大 的 灵活 性 ， 其 中 
涉及 多 种 方式 ， 如 XMIL、 注 解 和 Java 配置 。 但 需要 记 住 的 是 ， 随 着 Spring 应 用 程序 中 
模块 和 特性 数量 的 增加 ， 配 置 中 的 复 林 上 度 也 随 之 增加 。 在 经 历 了 某 一 关键 点 后 ，Spring 
应 用 程序 即 会 变 得 单调 乏味 。 易 于 出 错 。 

XTE, Spring Boot 可 以 解决 Spring 应 用 程序 配置 的 复杂 性 问题 。 

Spring Boot 会 为 用 户 目 动 完 成 某 些 任务 ， 同 时 允许 用 户 在 必要 时 修改 默认 值 。 

Spring Boot 并 不 是 一 个 独立 的 框架 ， 但 却 是 Spring 的 核心 内 容 。Spring Boot 构建 于 
Spring Framework 之 上 , 但 却 为 开 友 人 员 除 去 了 某 些 枯燥 的 工作 ， 以 使 开 友 人 员 通 过 最 小 
配置 或 雯 配置 方式 将 主要 精力 集中 于 业务 编码 上 。 

1.1 显示 了 Spring Boot 的 示意 图 。 
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在 图 1.1 中 可 以 看 到 ，Spring Boot 十 Spring Framework 有 的 表面 层 ， 且 包含 了 请 如 Web 
(MVC) 、JDBC、 安 全 和 批 处 理 这 一 类 模块 。 对 于 用 户 来 说 ，Spring Boot 仅 提供 了 较 小 
的 表面 区 域 以 从 Spring 中 获取 数值 。 

假设 用 户 正 与 菜 项 任务 (例如 Hello World 应 用 程序 ) 协同 工作 。 当 选取 Spring 
Framework 进行 开 友 上 时， 那么 需要 前 期 准备 哪些 工作 呢 ? 

下 面 列 出 了 小 型 Web 应 用 程序 所 需 的 最 低 程度 的 配置 。 

OD ”通过 Maven 或 Gradle 创建 项 目 结构 ， 并 定义 依 顿 关系 ， 例 如 Spring MVC 和 

Servlet 依赖 关系 。 
D ”部 署 描述 符 文件 ， 即 web.xml。 在 Java 配置 中 ， 则 需要 使 用 到 声明 了 Spring 的 
DispatcherServlet 的 WebApplicationInitializer 实现 类 。 

Q Spring MVC 配置 类 ， 以 启用 Hello World 应 用 程序 的 Spring MVC RIR, 

DO ”需要 创建 一 个 控制 苍 ， 以 啊 应 请 求 。 

OD ”需要 创建 一 个 Web 应 用 程序 服务 左 ， 例 如 Tomcat. 

其 中 , 大 多 数 内 容 均 为 通用 的 样板 代码 ,以 及 针对 Spring Web 应 用 程序 的 第 见 配置 ， 
除了 编写 特定 的 应 用 程序 控制 右 之 外 。 因 此 ，Spring Boot 根据 类 路 径 上 的 库 提 供 了 所 有 
的 稍 见 配置 和 样板 代码 ， 而 用 户 无 须 编 写 此 类 前 见 的 通用 代码 。 

下 面 利用 Spring Boot 构建 上 述 Hello World 应 用 程序 。 假 设 我 们 正在 使 用 一 个 基于 
groovy Hi ass. Un TZ: 

GRestController 

class HelloController | 

QGetMapping ("/") 
String hello() { 

#Hello Woridt:t!*" 
} 

} 

上 述 代 码 表 示 为 完整 的 Spring Web 应 用 程序 ， 且 无 顷 执 行 任何 配置 操作 一 一 未 涉及 
任何 web.xml 文件 、 构 建文 档 ， 甚 至 是 应 用 程序 服务 器 ， 这 是 一 个 完整 的 应 用 程序 。 利 
用 下 列 命 令 ， 可 通过 Spring Boot CLI 运行 该 应 用 程序 。 


$ Spring run HelloController.groovy 


因此 ， 我 们 可 以 看 出 Spring Boot 如 何 简 化 Spring 应 用 程序 的 开 有 友 过 程 。 在 1.3 7, 
我 们 还 将 看 到 同一 程序 洲 用 Java 时 的 状态 。 
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s3 Ee 
O 注意 : 

Spring Boot 无 意 与 Spring 或 Spring MVC 框架 实现 竞争， 仅 是 简化 Spring 应 用 程序 
的 开发 而 已 。 


1.3 Spring Boot 中 的 核心 组 件 


前 面 介 绍 了 Spring Boot 如 何 傈 化 Spring 应 用 程序 的 开发 过 程 ， 然 而 ， 其 背后 的 理念 
LÆTA? SEC, HESSE P Spring Boto 中 的 下 列 核心 组 件 : 

Spring Boot Starter. 

Q 明 动 化 配置 过 程 。 

Spring Boot CLI. 

Qd Spring Boot Actuator. 

ER 4 个 核心 组 件 简化 了 Spring 应 用 程序 的 开发 过 程 ， 下 面 分 别 对 其 加 以 考查 。 


1.3.1 Spring Boot Starter 


对 于 诸如 Web MVC. JDBC, ORM 5$ 45:3, Spring Boot Start 更 像 是 一 个 小 型 Spring 
项 目 。 对 于 Spring 应 用 程序 , HP SER F e EBEBEUIIBSHSITEH. (starter) 即 可 。 
相应 地 ，Spring Boot 将 确保 使 用 Maven 或 Gradle 将 必要 的 库 添 加 到 构建 信息 中 ， 而 开发 
人 员 无 须 担 心 模 块 库 和 该 库 的 依赖 版 本 ， 即 传递 性 依赖 关系 。 


O xs. 

Spring Boot 文档 中 描述 到 ，starter 表示 为 依赖 关系 描述 符 集合 ， 并 可 包含 至 应 用 程 
序 中 。 用 户 可 以 一 站 式 地 获得 所 需 的 所 有 Spring 和 相关 技术 ， 而 不 必 遍 历 示 例 代 码 并 复 
制 -粘贴 依赖 描述 符 的 载 入 过 程 。 


假设 需要 创建 一 个 Web 应 用 程序 ， 并 通过 Spring Web MVC 模块 回 Spring 应 用 程序 
显示 RESTful 服务 ， 对 此 ， 仅 需 在 项 目 中 包含 spring-boot-starter-web 依赖 关系 即 可 。 
在 Spring 应 用 程序 中 ， 对 应 内 容 如 下 所 示 : 


«dependencies» 
<dependency> 
<qgqroupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 
</dependencies> 
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starter 依赖 关系 负责 处 理 以 下 传递 性 依赖 关系 : 


" 
UJ 
m 
a 


spring-web-* jar. 
spring-webmvc-* jar. 
tomcat-* jar. 


jackson-databind-* jar. 


sprmg-boot-starter-web 


mas tru a 


spring-boot-autoconfigure spring-boot-starter-logging tomcat-embed-core 


tomcat-embed-logging-juli 


图 1.2 


spring-boot-starter 不 仅 降 低 了 构建 依赖 关系 的 数量 , 同时 还 回 构 建 信息 中 加 入 了 特定 
的 功能 。 在 当前 示例 中 ， 同 Spring 应 用 程序 中 添加 了 web 局 动 程 序 ， 因 而 可 提供 应 用 程 
序 所 需 的 Web 功能 。 类 似 地 ， 如 有 果 应 用 程序 将 使 用 到 ORM， 则 可 加 入 orm 局 动 程序 。 
对 于 安全 性 而 言 ， 可 加 入 security 局 动 程序 。 

Spring Boot 提供 了 大 量 的 Starter WH, Æ org.springframework.boot 分 组 中 ， 可 以 看 


到 以 下 内 容 。 
L] spring-boot-starter-web-services: 构建 显示 SOAP Web 服务 的 应 用 程序 。 
Q spring-boot-starter-web: 构建 Web 应 用 程序 和 了 RESTful 应 用 程序 。 
L] spring-boot-starter-test: 编写 单元 测试 和 集成 测试 。 
Q spring-boot-starter-jdbc: 传统 的 JDBC 应 用 程序 。 
Q spring-boot-starter-hateoas: 通过 添加 HATEOAS 特性 ， 使 服务 更 具 RESTful 
特征 。 
L] spring-boot-starter-security: 采用 Spring Security 的 身份 验证 和 授权 。 
L] spring-boot-starter-data-jpa: 基于 Hibernate 的 Spring Data JPA. 
L] spring-boot-starter-cache: 司 用 Spring Framework 的 绥 存 文 持 。 
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L] spring-boot-starter-data-rest: 使 用 Spring Data REST 显示 人 简单 的 REST 服务 。 
1.3.2 Spring Boot Starter Parent POM 


Starter Parent POM 定义 了 依赖 关系 和 Maven 插件 的 核心 版 本 , 通常 采用 spring-boot- 
starter-parent 作为 pom.xml 文件 中 的 父 级 ， 如 下 所 示 : 
«parent» 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-parent«/artifactlId» 
«version»2.0.2.RELEASE«/version» 
«relativePath/» «!-- lookup parent from repository 一 一 > 
«/parent» 
对 于 多 重子 项 目 或 模块 ，Spring Boot Starter Parent POM 可 管理 下 列 内 容 。 
D MA: Java 版 本 和 其 他 属性 。 
Q ”依赖 关系 管理 : 依赖 关系 的 版 本 。 
Q ”默认 插件 配置 ， 这 将 包含 诸如 构建 插件 的 配置 信息 。 
这 是 一 种 引入 多 个 协调 依赖 项 〈 包 括 传 递 依赖 项 ) 的 简单 方法 。 
FAZA Spring Boot 的 auto-configuration. 


1.3.3 Spring Boot auto-configuration 


Spring Boot 可 目 动 对 应 用 程序 的 各 项 功能 提供 相应 的 配置 ， 这 利 见 于 大 量 的 Spring 
应 用 程序 中 。auto-configuration 通过 下 列 方式 分 析 路 径 : 

QU Nix. Spring Boot 将 无 法 对 其 进行 配置 。 

D ”建议 使 用 依赖 关系 管理 工具 。 

L] Spring Boot Parent 和 Starter 将 对 此 了 予以 简化 。 

Q Spring Boot 将 与 Maven. Gradle. Ant/Ivy 协同 工作 。 

根据 所 添加 的 JAR 依赖 和 关系，Spring Boot 在 Spring 应 用 程序 中 提供 了 此 类 模块 的 日 
动 配置 功能 ， 假 说 在 Spring 应 用 程序 路 径 中 加 入 了 JPA 局 动 程序 依赖 项 ， 即 spring-boot- 
starter-data-jpa，Spring Boot 将 日 动 把 JPA 配置 至 Spring 应 用 程序 中 。 当 前 ， 用 户 并 未 过 
过 手动 方式 配置 与 JPA 关联 的 任何 数据 库 连 接 Bean。 类 似 地 , 如果 需要 加 入 诸如 HSQLDB 
这 一 类 内 存 数据 库 ， 则 可 将 其 〈org.hsqldb) WIE Spring 应 用 程序 的 类 路 径 中 ， 这 将 目 
动 配置 一 个 内 存 数据 库 。 
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Spring Boot 323. F 717; Xd Bt f B JMA RE: 

OD H2 SpringBoot 类 路 径 中 的 有 效 框 染 。 

Q BER, Spring Boot 针对 该 应 用 程序 租 看 现 有 的 配置 。 

据 此 ，Spring Boot 提供 了 所 需 的 基本 配置 内 容 ， 进 而 配置 基于 相关 框架 的 应 用 程序 ， 

一 过 程 称 作 auto-configuration. 

在 作者 编写 的 男 一 本 书籍 (Spring 5 Design Patterns) 中 ， 曾 编写 了 一 个 与 后 端 关 联 
的 应 用 程序 ， 并 通过 JDBC 访问 一 个 关系 型 数据 库 。 由 于 Spring Framework 提供 了 
JdbcTemplate， 因 而 需要 在 应 用 程序 上 下 文中 作为 Bean 注册 该 JdbcTemplate， 如 下 所 示 : 

Bean 

public JdbcTemplate jdbcTemplate(DataSource dataSource) { 

return new JdbcTemplate (dataSource); 


} 


上 述 配 置 创建 了 一 个 JdbcTemplate 的 实例 ， 并 利用 了 一 个 Bean 依赖 项 对 其 注入 。 
此 ， 还 需 注 册 这 一 DataSource Beans FIIR wR y aN) DataSource Bean 配置 
HSQL 数据 库 。 


Bean 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder() 
.SetType (EmbeddedDatabaseType .HSQL) 
.addserrpbEs('schema.sq01', 'data-stut'") 
.buildt):; 
} 


上 述 配置 使 用 HSQL RARA EEGIS—^^ DataSource 实例 ， 用 于 指定 SQL 脚本 
schema.sql 和 data.sql。 

可 以 看 到 ， 两 个 Bean 方法 定义 并 不 复杂 ， 但 并 不 是 应 用 程序 逻辑 内 容 中 的 一 部 分 ， 

这 只 十 应 用 程序 配置 的 一 小 部 分 。 如 末 回 同一 应 用 程序 中 诬 加 Spring MVC， 则 需要 注册 

另 一 个 对 应 的 Bean 方法 。 ETE Spring 应 用 程序 来 说 ， 此 类 方法 基本 相同 ， 并 于 其 中 
使 用 相同 的 模块 。 可 以 说 ， 这 是 每 个 Spring 应 用 程序 中 的 样板 代码 。 

简 而 言 之 ， 这 一 类 配置 (无 论 定义 了 何 种 内 容 ) 对 于 每 个 应 用 程序 来 说 均 是 一 种 公 
共 配 置 。 理 想 状 态 下 ， 不 应 针对 每 个 应 用 程序 加 以 编写 。 

Spring Boot 解雇 了 公共 配置 这 一 闫 问 题 ， 并 可 目 动 配置 这 些 公 共 配 置 Bean 方法 。 H 
体 来 说 ，Spring Boot 根据 应 用 程序 类 路 径 上 的 有 效 库 上 自动 配置 。 因 此 ， 如 果 需 要 在 应 用 
程序 类 路 径 上 添加 HSQL 数据 库 ，Spring Boot 将 自动 配置 符 入 式 HSQL 数据 库 。 
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如 果 Spring JDBC 库 位 于 应 用 程序 的 类 路 径 上 ， 还 将 针对 该 应 用 程序 配置 一 个 
JdbcTemplate Bean， 且 无 须 以 手动 方式 在 Spring 应 用 程序 中 配置 此 类 Bean。 这 些 Bean 
将 实现 目 动 配 置 ， 并 将 其 用 于 业务 馆 辑 。Spring Boot 在 开发 人 员 一 闹 减 少 了 此 类 样板 代 
位 配置 量 。 


1.3.4 局 用 Spring Boot auto-configuration 


Spring Boot j£ ft Y Spring Boot YENi, Mmi) H auto-configuration TTE. VATEAHTA T 
Spring Boot 应 用 程序 的 主 应 用 程序 中 。Spring Java 配置 关上 的 @EnableAutoConfiguration 
使 得 Spring Boot 目 动 创建 所 需 的 Bean,， 通常 会 根据 类 路 径 内 容 子 以 实现 (也 可 方便 地 对 
此 进行 修改 ) 。 
Fi f Vds Spring Boot 应 用 程序 中 的 主 应 用 程序 局 动 厚 关 : 
aConfiguration 
aEnableAutoConfiguration 
public class MyAppConfig { 
public static void main(String[] args) f 
SpringApplication.run(iMyAppContig-class, args}; 
} 

} 


除 此 之 外 ，Spring Boot 还 针对 访 配 置 文件 手 供 了 一 种 快捷 方式 ， 即 使 用 态 一 个 注解 
(Q)SpringBootApplication. 

BEJ w W.B 7; XX xe 3& IH] fii H] (QEnableAutoConfiguration ~  (Q)Configuration 、 
@ComponentScan。 考 个 下 列 更 新 后 的 代码 : 


aSpringBootApplication 

public class MyAppConfig 1 
public static void main(String[] args) { 
SpringApplication.run(MyAppConfig.class, args); 
} 

} 


在 上 述 代码 中 ，@ComponentScan 不 包含 任何 参数 ， 并 扫描 当前 包 及 其 子 包 。 
Spring Boot 1.2 之 后 方 对 (@SpringBootApplication 予以 支持 。 
EVITE, 1.3 较 好 地 解释 了 上 述 内 容 。 
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(B Configuration 
(i) ComponentScan 
(oEnableAutoConfiguration . | €«SpringBootApplication 


public class MyAppConfig { public class MyAppConfig { 


} } 


图 1.3 


根据 图 1.3 npn. (QSpringBootApplication 注解 涵盖 了 3 个 注解 的 功能 ， 即 
(VEnableAutoConfiguration、 (@ComponentScan, (@Configuration. 
O0 +s. 

Spring Boot Starter 减少 了 构建 的 依赖 关系 ; Spring Boot 自动 配置 则 降低 了 Spring 的 
配置 内 容 。 

如 果 希 望 排除 某 些 模块 的 auto-configuration， 则 可 使 用 @SpringBootAnnotation 的 
exclude 属性 。 考 合 下 列 代 人 : 


QSpringBootApplication (exclude = [DataSourceAutoConfiguration.class, 
HibernateJpaAutoConfiguration.class]) 


public class MyAppConfig { 


} 
在 上 述 代 但 中 可 以 看 到 , Spring Boot 应 用 程序 仅 将 DataSourceAutoConfiguration.class 
和 HibernateJpaAutoConfiguration.class 视 为 目 动 配置 。 
图 1.4 解释 了 与 Spring Boot auto-configuration 特性 相关 的 全 部 内 容 。 
”| 路 径 上 的 ， 注册 的 
Starter Web | | s pring M /C | DispatcherServlet 


IS: 路径 上 的 HSQLDB, 注册 后 的 嵌入 
dependency | | H2% Derby ` | 数据 源 


- 如 果 数据 源 ” ，”、 注册 后 的 
le | 已 注册 — JdbcTemplate 


将 模块 包含 至 应 Spring Boot 运行 期 Spring Boot 执行 的 
用 程序 中 检测 任务 


图 14 
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不 难 友 现 ， 1.4 PRES T Spring 应 用 程序 所 需 的 模块 。 在 运行 期 ，Spring Boot 
将 在 应 用 程序 类 路 和 任 上 检查 库 。 如 果 所 需 库 未 出 现 于 应 用 程序 的 类 路 入 上 ，Spring Boot 
将 针对 应 用 程序 配置 所 需 Bean 以 及 其 他 配置 内 容 。 用 户 无 顷 担心 Spring Boot 应 用 程序 
中 的 模块 配置 问题 。 

下 面 将 介绍 另 一 个 核心 组 件 Spring Boot CLI. 


1.3.5 Spring Boot CLI 


Spring Boot 提供 了 一 种 命令 行 工 具 ， 可 用 于 快速 编写 Spring 应 用 程序 。 通 过 Spring 
Boot CLI， 可 运行 Groovy 脚本 ， 与 Java 相 比 ，Groovy 代码 几乎 不 包含 任何 样板 代码 。 
Spring Boot 文档 中 摘 述 到 : 


“虽然 无 须 使 用 CLI 与 Spring Boot 协同 工作 , 但 这 绝对 是 局 动 Spring 应 用 程序 的 最 
WA A e. 


Spring Boot 的 CLI 为 开 肥 人 员 提 供 了 更 多 的 空余 时 间 ， 不 上 必 添 加 局 动 程 序 依 顿 项 和 
目 动 配置 , 从 而 只 专注 于 编写 特定 于 应 用 程序 的 代码 。 在 Groovy 脚本 HelloController 中 ， 
我 们 已经 看 到 了 这 一 氮 ; 随后 ， 可 利用 Spring Boot CLI i& 171 1Z Groovy 脚本 。 

Spring Boot CLI 是 一 种 智能 工具 ， 其 原因 在 于 ， 在 Groovy 脚本 中 并 不 涉及 导入 语句 
ÍT; M Spring Boot CLI 却 文 持 此 类 运行 方式 。 读 者 可 能 会 询问 ， 对 于 依赖 关系， 情况 又 
是 如 何 ? 此 处 并 未 包含 Maven 或 Gradle, CLI 的 智能 体现 于 ， 它 检测 应 用 程序 中 所 使 用 
的 类 ， 同 时 了 解 应 该 为 这 些 类 使 用 哪些 starter 依赖 关系 。 

当 Spring Boot 添加 依赖 项 时 , 一 系列 的 auto-configuration 会 启动 并 添加 所 需 的 Bean 
方法 配置 ， 这 样 应 用 程序 就 能 够 啊 应 HTTP 请 求 。 

CLI Æ Spring Boot 中 的 一 项 可 选 内 容 ， 且 只 允许 开发 人 员 使 用 应 用 程序 代码 编写 完 
整 的 应 用 程序 ， 而 不 需要 构建 传统 的 项 目 。CLI 为 Spring 开发 提供 了 强大 的 功能 ， 同 时 
又 不 失 催 音 性 。 第 2 章 将 讨论 如 何 设 置 Spring Boot CLI.» 

接 下 来 讨论 Spring Boot 构建 模块 的 另 一 个 核心 组 件 ， 即 Spring Boot Actuator。 访 组 
件 将 生成 一 些 与 Spring Boot 应 用 程序 运行 相关 的 反馈 信息 。 


1.3.6 Spring Boot Actuator 


许多 框架 均 提 供 了 应 用 程序 开发 工具 ， 但 Spring Boot 不 仅 限 于 此 ， 它 还 提供 了 一 个 
生产 环境 的 后 期 特性 ， 进 而 可 在 生产 期 间 使 用 HTTP miek JMX 监视 Spring 应 用 程序 。 
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Spring Boot Actuator 是 Spring Boot 构建 模块 的 最 后 一 个 核心 组 件 。Spring Boot 构建 
模块 的 其 他 部 分 用 于 人 简化 Spring 的 开发 过 程 ， 相 反 ，Spring Boot Actuator 则 提供 了 运行 
期 时 检测 应 用 程序 内 部 状态 的 能 力 。Spring Boot Actuator 使 用 HTTP ij £i 2X JMX 提供 有 
关 审 计 、 指 标 和 Spring Boot 应 用 程序 健康 状况 的 数据 。 当 应 用 程序 被 推 入 生产 环境 时 ， 
以 帮助 用 户 管理 应 用 程序 。 

"AE Spring Boot WHFS P Z3 f. Actuator 后 ， 即 会 捉 供 以 下 功能 : 


" 
E 
E 


E 
n" 
图 


提供 了 配置 于 Spring 应 用 程序 上 下 文中 全 部 Bean 的 详细 信息 。 

提供 了 与 Spring Boot 的 auto-configuration 相关 的 详细 信息 。 

确保 全 部 环境 变量 、 系 统 属性 、 配 置 属性 和 命令 行 参数 针对 当前 应 用 程序 均 为 
HX 

Actuator 可 生成 与 内 存 应 用 、 世 圾 回收 、Web 请 求 和 数据 源 使 用 相关 的 各 种 指标 。 
壹 供 了 应 用 程序 所 处 理 的 最 近 HTTP 请 求 的 跟 踩 信息 。 

提供 了 与 Spring Boot 中 当前 线程 状态 相关 的 信息 。 


Spring Boot Actuator 馆 过 以 下 两 种 方式 提供 了 列表 信息 : 


E 
E 


使 用 Web 端点 。 
通过 Shell 界面 对 其 加 以 使 用 。 


在 第 3 半 中 将 证 细 讨论 Spring Boot Actuator 的 各 项 功能 。 

前 面 讨 论 了 Spring Boot 的 全 部 构建 模块 ， 此 类 模块 以 各 目的 方式 用 于 简化 Spring 应 
用 程序 的 开发 过 程 , 下 面 将 探讨 如 何 设置 Spring Boot 工作 区 ,进而 开发 第 一 个 Spring Boot 
应 用 程序 。 


1.4 设置 Spring Boot 工作 区 


A pBijieul Wu t£ Spring Boot 工作 区 ， 进 而 生成 Spring Boot 应 用 程序 。 议 置 Spring 
Boot 应 用 程序 不 需要 特定 的 工具 和 集成， 读者 可 使 用 任意 的 IDE 或 文本 编辑 器 。 但 Spring 
Boot 2.0 至 少 需要 以 下 内 容 : 

口 JavaSDK v1.8 或 更 高 。 

L] Spring Framework 5.0.0.RELEASE 或 更 局 。 

Q Maven (3.2+) 和 Gradle 4. 

O “Tomcat 8.5。 也 歌 是 说 ， 一 个 与 Servlet 3.038 7E HJ 3 68 e 

接 下 来 通过 以 下 方式 针对 Spring Boot 设置 工作 区 。 

Q 利用 Maven iX & Spring Boot. 
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Q ”利用 Gradle 设置 Spring Boot. 
下 面 详细 探讨 如 何 利 用 Maven 和 Gradle 设置 Spring Boot 应 用 程序 。 


1.4.1 利用 Maven 设置 Spring Boot 


Spring Boot 兼容 于 Apache Maven 3.2( 或 更 高 )。 如 果 读 者 的 机 器 上 尚未 安装 Java 8 
(或 更 高 版 本 ) , 可 访问 Oracle 的 官方 网 站 http://www.oracle.com/technetwork/java/javase/ 

downloads/jdk8-downloads-2133151.html 下 载 Java 8. 

如 果 用 户 尚 未 安装 Maven， 可 访问 https://maven.apache.org/FfT FX; Ubuntu 用 户 可 运 
ÍT sudo apt-get install maven 进行 安装 。 下 列 内 容 显 示 了 Spring Boot 与 org.springframework. 
boot groupId [H] I] XE; 2 « 

«?xml versi(ion—"1:0" encoding="UTF-8"?> 

«project xmlns-"http://maven.apache.org/POM/4.0.0" 

xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 

xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 


http: //maven.apache.org/xsd/maven-4.0.0.xsd"» 
xmodelVersion»4.0.0«/modelVersion» 


«parent» «€«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-parent«/artifactId» 
«version»2.0.2.RELEASE«/version» «relativePath/» <!-- lookup parent 
from repository --> «/parent» 

«dependencies» 

«dependency» 
«groupId»org.springframework.boot«/groupId» «artifactId»spring-boot- 
starter-web«/artifactId» 
«/dependency» 


«/dependencies» 


«/project» 


对 于 Spring Boot 2.0 来 说 ，.pom 文件 可 视 为 最 小 需求 条 件 。 
Fifi"; £r Spring Boot 的 Gradle 设置 。 


1.4.2 ”利用 Gradle 设置 Spring Boot 


如 前 所 述 ， 无 论 是 Maven 还 是 Gradle，Java 8 是 Spring Boot 2.0 的 最 低 需 求 条 件 。 
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当 使 用 Gradle 时 ， 首 先 需 要 在 机 器 上 安装 Grade 4 或 更 高 版 本 ， 对 应 的 下 载 地 址 为 


www.gradle.org/. 
接 下 来 得 看 Gradle Spring Boot 5 org.springframework.boot groupId 间 的 依赖 关系 文 


件 。 其 中 ，build.gradle 文件 如 下 所 示 : 


buildscript | 
repositories 1 
jJcenter () 
maven | url 'http://repo.spring.io/snapshot! ] 
maven [ url 'http://repo.spring.io/milestone'! | 
} 
dependencies { 
classpath 'org.springframework.boot:spring-boot-gradleplugin: 
2 0 0- MI 
i 
} 
apply plugin: "java 
apply plugin: 'org.springframework.boot' 
apply plugin: 'io.spring.dependency-management'l'l 


jar i 
baseName = 'HelloWorld' 
version — '0.0.1-SNAPSHOT' 


repositories 1 
jcenter () 
maven { url "http://repo.spring.io/snapshot" } 
maven { url "http://repo.spring.io/milestone" | 


dependencies { 
compile ("org.springframework.boot:spring-boot-starter-web") 
testCompile("org.springframework.boot:spring-boot-starter-test") 
} 
FR Gradle 文件 包含 了 Spring Boot 应 用 程序 的 最 低 需 求 条 件 。 鉴 于 处 理 过 程 相同 ， 
Hi? uff HF] Maven 或 Gradle, Spring Boot T4 H1 TH IR] E] AE OSEE GJ $E FH RET « 
FASAN Spring Boot NL HIE. FAA UPAH Boot Initializr 设置 项 目 
的 结构 。 
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1.5 开发 第 一 个 Spring Boot 应 用 程 厅 


FEKE Java 中 创建 一 个 Hello World REST 应 用 程序 ， 同 时 生成 一 个 简单 的 REST 
服务 , 并 在 请 求 时 返回 一 个 Hello World 消息 。 在 该 应 用 程序 中 , 将 采用 Maven 构建 项 目 。 

读者 可 能 已 经 注意 到 ， 即 使 创建 一 个 简单 的 项 目 结构 ， 仍 会 面临 某 些 困 难 。 例 如 ， 
是 否 设置 了 配置 文件 、 属 性 文件 等 ;， 是否 利 用 依赖 关系 构建 了 文件 ? 从 传统 方式 来 看 ， 
当 解 决 此 类 问题 ， 并 获得 一 种 较为 方便 的 项 目 构 建 方案 时 ， 开 发 人 员 人 往往 会 访问 Google 
并 搜索 某 些 可 行 方案 。 

然而 ， 随 着 Spring Boot 的 出 现 ， 情 况 也 随 之 产生 了 变化 。Spring Boot 团队 为 读者 提 
供 了 一 种 项 目 结构 解雇 方案 ， 即 Spring Boot Initializr。 

Spring Boot Initializr 针对 所 有 与 放置 工作 相关 的 问题 所 供 了 相应 的 解雇 方 宁 , 同时 创 
建 了 更 为 传统 的 Java W H AT 

Spring Boot Initializr 是 一 个 Web 应 用 程序 ,并 可 创建 一 个 Spring Boot 项 目 结构 ， 且 过 
ff Maven 或 Grade 构建 规范 一 一 这 取决 于 采 单 中 的 选项 。 但 需要 记 住 的 是 ，Spring Boot 
Initializr 并 不 生成 任何 应 用 程序 代码 。Spring Boot Initializr 包含 了 多 种 使 用 方式 ， 具 体 如 下 : 

Q 其 于 Web 界面 的 Spring Boot Initializr( 对 应 网 址 为 https://start.spring.io? 。 

JU 还 可 通过 IDE 使 用 Spring Boot Initializr, 例如 Spring Tool Suite (STS) 和 IntelliJ 

IDEA. 
”使 用 Spring Boot CLI. 
第 3 章 将 讨论 基于 Spring Boot CLI 的 Spring Boot Initializr。 下 面 首先 介绍 前 两 种 方式 。 


1.5.1 使 用 Web Xi 


Spring 团队 发 布 了 一 个 Web 应 用 程序 (对 应 网 址 为 https://start.spring.io) ， 这 也 是 最 
HPH] Spring Boot 创建 方式 ， 同 时 也 是 一 种 较为 耳 观 的 Spring Initializr 应 用 方式 。 其 
中 包含 了 全 部 荣 单 选项 ， 读 者 可 以 在 应 用 程序 中 加 以 选择 和 使 用 。 

图 1.5 显示 了 Spring Initializr 的 主页 。 

可 以 看 到 ， 其 中 包含 了 多 项 需要 盾 与 的 选项 ， 如 下 所 不。 

L] Project type: Maven 或 Gradle. 

Q Language: Java, Kotlin 或 Groovy. 

Q Spring Boot 版 本 。 
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SPRING INITIALIZR 


Generate a vaenpoecg with ,aa v; and Spring Boot 200m7 


Project Metadata Dependencies 


Artifact coordinates Add Spring Boot Starters and dependencies to your application 


Group Search for dependencies 


Artifact 
Web 
mastering-spring-hoot Full-ztack wab development with Tomcat and Spring MVC 


Reactive Web 
Reactive web development with Netty and Spring WebFlux 


Generate Proje Rest Repositories 
Exposing Spring Data repositories over REST via spring-data-rest-webmwvc 


Don't know what to look for? Want more options? Swit : 
P Validation 


JSR-303 validation infrastructure (already included with wel) 
Rest Repositories HAL Browser 
Browsing Spring Data REST repositories in your browser 


A Ne - i : Mare matches, please refine your search 
start.sprinq.io is powered by Spring Initializr and Pivotal Web Services 


图 1.5 


在 SPRING INITIALZR ŁR, REAM maA fe^] N90 H 7629008 A i he OE 
项 目的 Group 和 Artifact. 

当 SPRING INITIALZR 询问 时 ， 可 填 入 简单 的 信息 ， 并 选择 构建 系统 、 有 所 用 语言 以 
及 Spring Boot 的 版 本 号。 随后 ， 根 据 沫 单 内 容 选 择 应 用 程序 的 依赖 天 系 ， 并 提供 项 目的 
Group 和 Artifact。 单 击 Generate Project 按钮 后 ， 即 可 得 到 一 个 可 执行 的 应 用 程序 。 

此 处 分 别 选取 了 Spring Boot 2.0.2、 下 拉 六 单 中 的 Maven, K FHH H] Java 语 
言 。 随 后 ， 可 按照 下 列 方式 指定 项 目的 Group 和 Artifact. 


JW Group: com.dineshonjava.masteringspringboot. 


Qd] Artifact: mastering-spring-boot. 

下 面 讨 论 与 Web JZmTHASHU —7 pp. L5 Web 界面 下 方 的 Switch to the full 
version 超 链 接 后 ， 将 会 提供 更 多 的 选项 ， 进 而 可 选择 更 多 内 容 。 除 此 之 外 ， 还 可 指定 版 
本 和 基础 包 名 这 一 类 额外 的 元 数据 。 

在 图 1.5 中 ， 我 们 加 入 了 项 目 描述 、 包 名 、 包 类 型 (JAR 或 WAR) ; 此 外 ， 还 可 进 
一 步 选 择 Java 版 本 。 随 后 单 击 表单 中 的 Generate Project 按钮 ， 以 使 Spring Initializr 生成 
项 目 。 

Spring Initializr 将 此 作为 一 个 ZIP 文件 予以 提供 ， 并 命名 为 Artifact 字段 中 的 内 容 ， 
并 通过 浏览 器 进行 下 载 。 在 当前 示例 中 ， 该 AIP 文件 命名 为 masteringspring-boot.zip。 

解压 该 文件 后 ， 对 应 的 项 目 结构 如 图 1.6 所 示 。 
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(5 mastering-spring-boot [boot] 
4 (© src/main/Java 
4 H3 com.dineshonjava.masteringspringboot 
. |J] MasteringSpringBootApplication.java 
4 (© src/main/resources 
E static 
[— templates 
/— application.properties 
a (BE src/test/Java 
4 H3 com.dineshonjava.masteringspringboot 
> [|J] MasteringSpringBootApplicationTests.java 
Bh JRE System Library [JavaSE- 1.8] 
\ Maven Dependencies 
Eo» src 


= target 


三 | mvnw 
cu mvnw.cmd 
| pom.xml 


图 1.6 


可 以 看 到 ， 当 前 项 目 中 包含 了 较 少 的 代码 ， 同 时 生成 了 一 组 空 目录 。 相 应 地 ， 所 生 
成 的 项 目 包含 以 下 内 容 。 


E 
" 


E 


" 


pom.xml: Maven T4 Zo yo. 

MasteringSpringBootApplication,ava: 包含 main0 方 法 的 类 ， 用 以 引导 当前 应 用 
程序 。 

MasteringSpringBootApplicationTests.java: 空 的 JUnit 测试 类 , 并 通过 Spring Boot 
auto-configuration 加 载 一 个 Spring 应 用 程序 上 下 文 。 

application.properties: 一 个 空 的 属性 文件 , 可 以 根据 需要 将 配置 属性 添加 到 其 中 。 
static H3: 可 以 将 任何 要 从 Web 应 用 程序 提供 的 静态 内 容 放 置 在 其 中 ， 如 
JavaScript、 样 式 表 、 图 像 等 。 

templates 目录 : 可 放置 显示 模型 数据 的 模板 。 


最 后 ， 将 该 项 目 导 入 UDE 中 。 当 采用 Spring Tool Suite IDE 时 ， 可 文 持 Spring Boot 
应 用 程序 的 创建 操作 ， 因 而 无 须 再 次 访问 Web 界面 。 
下 面 讨论 如 何 利 用 STS IDE 创建 一 个 Spring Boot 项 目 。 


L3 


利用 STS IDE 创建 Spring Boot 项 目 


对 于 Java 开发 人 员 来 说 ，Spring Tool Suite 是 一 个 较为 流行 的 IED 工具 之 一 , 进而 在 
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此 基础 上 开发 Spring 应 用 程序 。 如 果 机 器 上 尚未 安装 STS, 可 访问 http://spring.io/tools/sts 
下 载 最 新 的 版 本 。 
选择 File 一 New 一 Spring Starter Project 命令 ， 将 在 STS 中 创建 一 个 新 的 Spring Boot 
应 用 程序 。 随 后 ，STS 将 弹出 如 图 1.7 所 示 窗 口 。 
L2 


New Spring Starter Project 


Name mastering-spring-boot 
Use default location 


Location D:\packt-spring-boot-ws\mastering-spring-boot 


Type: | Maven " Packaging: Jar v 


Java Version: 8 v Language: Java v 


Group com.dineshonjava 


Artifact masteringspringboot 


Version 0.0.1- SNAPSHOT 


Description mastering-spring-boot project for Spring Boot 


Package com.dineshonjava.masteringspringboot 
Working sets 
[ | Add project to working sets | New... 


Mg rk Ifl t] * et ^ Sel ect. re 


Cancel 


图 1.7 


在 图 1.7 中 可 以 看 到 ， 用 户 将 被 询问 相关 信息 (与 Spring Initializr 相同 ) 。 此 处 读者 
可 填写 相同 的 内 容 。 

单 击 Next 按钮 ， 将 显示 如 图 1.8 所 示 的 第 二 个 窗口 。 

单 击 Finish 按钮 后 ， 将 采用 与 ZIP 文件 中 Web 方案 相同 的 目录 结构 和 默认 文件 ， 在 
工作 区 中 显示 项 目 结构 。 
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New Spring Starter Project 


Site Info 


Base Url http://start.spring.io/starter.zip 


Full Url http://start.spring.io/starter.zip?namez mastering-spring- ^ 
boot&groupldz com.dineshonjava&artifactldz masteringspringboot 
&versionz0,0.1-SNAPSHO T &descriptionz mastering-spring-boot 
*project«for- Spring 
*Boot&packageNamez com.dineshonjava.masteringspringboot&ty v 


Finish | | Cancel 


图 1.8 


为 了 确保 正常 工作 ， 还 需 连 接 至 互联 网 上 ， 其 原因 在 于 ，STS 委托 至 http://start. 
spring.io 处 的 Spring Initializr 以 生成 当前 项 目 。 
人 至此， 当前 项 目 己 被 导入 工作 区 内 ， 接 下 来 将 创建 相应 的 应 用 程序 文件 ,例如 控制 器。 


1.6 实现 REST 服务 


简单 的 REST 控制 器 的 构建 过 程 如 下 所 示 : 


package com.dineshonjava.masteringspringboot.controller; 


import org.springframework.web.bind.annotation.GetMapping; 


import org.springframework.web.bind.annotation.RestController; 


RestController 
public class HelloController [( 


QGetMapping ("/hello") 
String sayHello()í 


return Helle WorprIdtito 


} 
下 面 详 细 讨 论 这 一 小 型 REST 控制 器 CHelloController) . 


. 2() * 


" 


a 
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(QRestController 注解 : 表明 这 是 一 个 控制 器 类 ， 其 结果 写 入 啊 应 体 ， 且 不 希望 
ARISE 

@GetMapping 注解 : 表示 一 个 请 求 处 理 方法 , 同时 也 是 @RequestMapping(method = 
RequestMethod.GET)IT] — F} [5] 53 TE RE. 

sayHello()77 1X: 返回 一 条 问候 消息 。 


在 STS IDE 中 ， 选 择 Run— Run As— Spring Boot Application áp, BI RIF] ER ACA 
服务 器 并 作为 一 个 Spring Boot 应 用 程序 运行 当前 程序 ， 如 图 1.9 所 示 。 


Run As t| 8 TRunonServer Alt+Shift+X, R 
Debug As d m 2 Java Application Alt- Shift X, J 
Profile As ki 3Spring Boot App Alt-Shift- X, B 
Validate 


Run Configurations... 
Restore from Local History... 站 D u————————————— 


图 1.9 
Spring Initialzr 将 创建 一 个 main 应 用 程序 局 动 类 ， 如 下 所 示 : 


package com.dineshonjava.masteringspringboot; 


import org.springframework.boot.SpringApplication; 


import org.springframework.boot.autoconfigure.SpringBootApplication; 


aSpringBootApplication 


public class MasteringSpringBootApplication { 


pubid3e static void madsn(5tringl|]| args} | 


SpringApplication.run(MasteringSpringBootApplication.class, args); 


} 
这 个 小 型 类 实际 上 是 一 个 完全 可 操作 的 Web 应 用 程序 。 下 面 来 看 看 其 中 的 一 些 细 节 
内 容 。 

L) (aQSpringBootApplication: IZEBA Spring Boot, AZE, 35034308 2908 02 
中 的 Spring 组 件 ， 并 对 其 进行 注册 。 际 此 之 外 ， 还 将 过 知 Spring Boot 后 用 auto- 
configuration。 其 间 ， 将 根据 类 路 径 设置 、 属 性 设置 中 的 内 容 以 及 其 他 因素 目 动 
创建 Bean。 

L]  mainQ77iA: 这 是 一 个 简单 的 public static void maing0 方 法 ， 以 运行 当前 应 用 程序 。 

Q  SpringApplication.run: SpringApplication 类 负责 创建 Spring 应 用 程序 上 下 文 ; 
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run0 方 法 将 初始 化 Spring 应 用 程序 中 的 上 下 文 。 
下 面 运行 Spring Boot 应 用 程序 ， 图 1.10 显示 了 控制 台中 的 日 志 内 容 。 


Æ Console 23 | BH Progress |*! Problems 


mastering-spring-boot - MasteringSpringBootApplication [Spring Boot App] C:\Program FilesJavasjre1.8.0 15T&binjavaw.exe (19-Feb-2018, 10:55:31 


2018-02-19 
2018-02-19 
2018-02-18 
2018-02-19 
2018-02-19 
2018-02-18 
2018-02-19 
2018-02-19 
2018-02-15 
2018-02-19 
2018-02-19 
2018-02-19 
2018-02-19 
2018-02-19 
2018-02-19 
2018-02-19 


ha 


main] c.d.m.Me 

main] c.d.m.M. 

main] Co 

main] o.h.v.i.engine 

main] o.3s.b.w. 

main] o.apache. 

main] org. 
[Dst-startStop-1] o.a.catalinse 
[ost-startStop-1] o.a.c. 
[oOst-start5top-1] o.s.w 
[ost-startS5top-1] s.v. 
[ost-startStop-1] s 
[ost-start5top-1] s. 
[ost-startStop-1] o. ile 
[ost-startStop-1] o.s5.w.s ndl 
[ost-startStop-1] o.s.w. 


图 1.10 


在 控制 全 日 志 中 ， 可 以 看 到 多 种 信息 ， 有 具体 如 下 : 

Q “日 志 上 方 显示 了 Spring Boot 标志 以 及 Spring Boot 版 本 。 

OD ”通过 创建 banner.txt 文件 或 者 banner.png 图 像 ， 并 将 其 置 入 src/main/resources/ 
文件 夹 中 ， 还 可 添加 自己 的 ASCII 标志 。 

D BAR Tomcat 服务 器 的 服务 器 端口 为 8080; 此 外 ,还 可 向 application.properties 
文件 中 添加 server.port 属性 ， 并 自 定义 该 端口 ， 如 下 所 示 : 


server.port- 98181 


口 “ 日 志 中 还 显示 了 应 用 程序 所 有 可 能 的 请 求 映 射 ， 如 图 1.11 所 示 。 
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图 1.11 


从 图 1.11 rPRHTEUEE US. PERHEEH3S 1T T SAU SIR ARE. BEACH DS AS tg 
[173 8080。 下 面 在 系统 浏览 器 上 对 其 稍 作 调整 ， 如 图 1.2 所 示 。 
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Ls > m http://localhost:3080/h: D ~ Ó ] Æ localhost 


Hello World!!! 


图 1.12 


至 此 , 我 们 创建 了 一 个 较为 简单 的 Hello World REST 应 用 程序 , 并 将 其 运行 于 Spring 
Boot 的 Tomcat ERA AIRI ZSE. 
下 面 考查 Spring Boot 2.0 中 的 新 增 特性 。 


1.7 Spring Boot 2.0 中 的 新 特性 


2014 4E, Spring Boot 首次 肥 布 ; 2018 F, Spring Boot 推出 了 新 的 版 本 ， 并 更 新 至 
Spring Boot 2.0， 其 中 包含 了 许多 新 特性 。 下 面 列 出 了 一 些 较为 重要 的 变化 。 

D 发布 了 许多 新 的 数据 包 和 Starters， 以 实现 更 好 的 依赖 关系 管理 。 

Q Spring Boot 2.0 文 持 auto-configuration， 从 而 减少 了 配置 量 。 

OD iB Actuator， 引 入 了 更 好 的 日 志 记 录 机 制 。 

2 ”软件 质量 测试 和 工具 得 到 了 进一步 的 完善 ， 同 时 也 这 来 了 更 好 的 用 户 体验 。 利 
用 spring-boot-devtools， 用 户 可 获得 更 完善 的 反馈 信息 。 
Spring Boot 2.0 X. x f Java 8 及 其 更 高 版 本 ,这 也 是 支持 Java 9 的 少数 选项 之 一 。 
Gradle 插件 被 BootJar 和 BootWar Pr & 4X. 
依赖 关系 常理 插件 将 不 再 被 目 动 激活 。 
安全 性 得 到 了 提升 。 
啊 应 式 模块 包含 了 不 同类 型 的 最 新 starter， 例 如 WebFlux. 
Actuator 升级 后 变化 较 大 。 以 前 ，Actuator 仪 支持 Spring MVC; 但 是 在 2.0 版 本 
H, Actuator 则 是 一 个 独立 的 组 件 。 

Spring Boot 2.0 中 涵盖 了 许多 令 人 兴奋 的 新 特性 以 及 增强 内 容 ， 在 后 续 章 节 中 ， 我们 
将 通过 具体 示例 展示 这 些 新 特性 。 
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本 章 简 要 介绍 了 Spring Boot 提供 的 各 项 功能 。 其 中 , 我 们 学 习 了 Spring Boot 如 何 简 
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化 Spring 应 用 程序 开发 任务 。 其 间 涉 及 诸多 核心 组 件 ， 如 Spring Boot auto-configuration, 
Starters. Spring Boot CLI, Spring Boot CLI 和 Spring Boot Actuator。 开 发 人 员 可 以 利用 
Spring Boot Starter 的 依赖 性 和 auto-configuration, 进而 只 关注 应 用 程序 逻辑 ,而 不 是 配置 
和 构建 依赖 关系 、 库 和 版 本 管理 , 从 而 快速 开发 Spring 应 用 程序 。 同 时, auto-configuration 
还 显 者 降低 了 样板 配置 的 代码 量 。 

另外 ， 本 章 还 创建 了 一 个 十 分 简单 的 Hello World REST 应 用 程序 ， 并 使 用 了 基于 
Web 的 Spring Initializr 和 Spring Tool Suite IDE. 相应 地 , RANEA Tomcat 容器 运 
行 了 该 程序 。 

第 2 章 将 深入 讨论 Spring Boot auto-configuration， 及 其 在 Spring Boot 应 用 程序 中 的 
定制 操作 。 
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当 修 改 每 个 模块 中 的 auto-configuration 时 ，Spring Boot 为 读者 提供 了 相对 目 由 的 选 
项 ， 且 并 不 会 强制 用 户 使 用 默认 设置 。 本 章 将 考 租 如 何 使 用 属性 和 YML 文件 修改 
auto-configuration« 

几 天 前 , 我 的 一 个 朋友 购买 了 一 辆 汽车 ,厂商 提供 了 相应 的 外 部 装饰 可 供 客 户 选 择 ， 
以 使 其 看 起 来 更 像 是 一 辆 跑车 。 客 户 可 更 改 闫 色 组 合 、 大 灯 、 轮 胎 、 车 门 LED 灯 等 。 也 
束 是 说 ， 和 车辆 可 根据 客户 的 具体 需求 而 配置 。 

男 一 方面 ， 车 辆 的 大 多 数 模 块 无 法 更 改 ， 客 户 可 通过 目 动 配置 方式 予以 购买 。 茶 些 
公司 提供 了 目 动 配置 方案 ， 客 户 可 直接 订购 车 身 的 内 部 和 外 部 颜色 。 汽 车 销售 商 一 般 会 
给 出 包含 颜色 定制 的 订单 ;， 否则 ， 他 们 一 般 不 会 对 车 身 颜 色 提 供 相 关 建 议 。 

大 多 数 车 辆 或 销售 商 允 许 客 户 对 所 购买 的 车 辆 进行 定制 ， 因 此 ， 客 户 会 购买 到 一 辆 
配备 默认 配置 的 预 置 车 辆 。 类 似 地 ， 当 用 户 与 传统 的 Spring 配置 协同 工作 时 ， 也 具有 对 
Spring 配置 完全 可 控 的 权力 ， 这 一 点 与 购买 车 辆 并 指定 相关 特性 十 分 类 似 。 

Spring Boot auto-configuration 就 像 是 在 购买 销售 中 的 汽车 ， 让 Spring Boot 处 理 细节 
要 比 在 应 用 程序 上 下 文中 声明 每 个 Bean 容易 得 多 。 然 而 ，Spring Boot auto-configuration 
则 更 具有 灵活 性 ， 并 可 操控 auto-configuration 的 使 用 方式 。 

在 阅读 完 本 章 后 ， 读 者 将 了 解 如 何 通 过 显 式 配 置 和 基于 属性 的 细 粒 度 配 置 体现 其 灵 


活性 。 
本 章 主 要 涉及 以 下 主题 : 
理解 auto-configuration. 
定制 Spring Boot。 
修改 Spring Boot 的 auto-configuration. 
使 用 属性 外 部 化 配置 。 
志 记 录 的 调 优 。 
使 用 YAML 进行 配置 。 
JE HI MHI FEST FER I H o 
下 面 将 对 此 加 以 逐一 讨论 。 
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2.1 理解 auto-configuration 


根据 模块 及 其 关联 库 依赖 天 系 ，Spring Boot auto-configuration 针对 Spring 应 用 程序 
提供 了 目 动 配置 操作 。 例 如 ， 如 果 在 类 路 径 中 加 入 了 骨 入 式 内 存 数 据 库 H2， 则 无 须 通 过 
手动 方式 对 与 数据 库 (如 DataSource, JdbcTemplate 等 ) 关联 的 任何 Bean 进行 配置 。 在 
回应 用 程序 类 路 径 中 加 入 了 H2 数据 库 依赖 项 后 ，Spring Boot 利用 auto-configuration 问 
用 户 提 供 H2 数据 库 。 

针对 Spring Framework 的 每 个 模块 ， 通 过 预 写 @Configuration 类 ，(@Configuration 所 
供 了 强大 的 目 动 配置 功能 ， 但 目 动 配置 根据 以 下 内 容 被 激活 : 

QD Spring 应 用 程序 的 类 路 径 内 容 。 

Do ”应 用 程序 中 设置 的 属性 。 

D ”应 用 程序 中 已 定义 的 Bean. 

Spring Framework 的 @Profile 注解 即 是 一 个 条 件 配 置 示例 。Spring Boot 将 这 一 思想 提 
升 到 了 一 个 新 的 层次 ， 并 在 传统 的 Spring Framework 上 提供 了 一 个 auto-configuration 层 。 
XX LAE Jf A Spring Boot 本 质 上 并 不 是 一 个 独立 的 框架 ， 它 是 一 个 Spring Framework. 


O +s. 


@Profile 可 视 为 @Conditional 的 一 个 特例 . 


注解 @Conditional 的 作用 如 下 : 

DQ” 允许 创建 条 件 Bean。 仅 在 其 他 Bean 存在 (或 不 存在 〉 时 创建 一 个 Bean， 如 下 
所 示 : 

QBean 

aConditionalOnBean (name-[("dataSource"]) 


public JdbcTemplate jdbcTemplate(DataSource dataSource) { 


return new JdbcTemplate (dataSource); 


} 
2 ”通过 检测 其 他 类 的 类 型 ， 注 解 @Conditional 可 创建 Bean， 如 下 所 示 : 
QBean 


aConditionalOnBean (type={DataSource.class}) 
public JdbcTemplate JdbcTemplate (DataSource dataSource) { 
return new JdbcTemplate (dataSource); 


} 
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Q (Conditional 注解 下 还 包含 了 许多 其 他 选项 ， 如 下 所 示 : 

>  (QConditionalOnClass. 

>  (QConditionalOnProperty. 

> (ConditionalOnMissingBean. 

>  (QConditionalOnMissingClass: 
接 下 来 讨论 Spring Boot 中 的 auto-configuration 类 。 它 是 spring-bootautoconfigure JAR 

文件 中 org.springframework.boot.autoconfigure 数据 包 内 的 预 写 Spring 配置 ， 如 下 所 示 : 

aConfiguration 


public class DataSourceAutoConfiguration implements EnvironmentAware I 


QàConditional(...) 

aQConditionalOnMissingBean (DataSource.class) 
ülmporbíi.--) 

protected static class EmbeddedConfiguration [ ... } 


} 
Spring Boot 定义 了 多 个 配置 类 ， 并 在 啊 应 Spring 应 用 程序 类 路 径 上 的 依赖 项 时 被 
UB o 
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2.2 定制 Spring Boot 


Spring Boot 可 对 auto-configuration 予以 全 面 操 控 。Spring Boot 配置 的 定制 操作 包含 
多 个 选项 ， 如 下 所 示 : 

LU ”在 属性 或 YAML 文件 中 放置 Spring Boot 的 条 些 属性 。 

口 “ 此 外 ， 还 可 亲自 定义 特定 的 Bean， 以 使 Spring Boot 不 再 使 用 默认 项 。 

口译 式 地 共用 示 些 配置 。 

QUK A. 

接 下 来 将 详细 讨论 上 述 4 点 内 容 ， 并 考查 如 何在 Spring 应 用 程序 中 定制 Spring Boto 
配置 。 


2.2.1 利用 Spring Boot 属性 进行 定制 


Spring Boot 文 持 应 用 程序 配置 的 定制 行为 , 并 可 在 不 同 的 环境 中 使 用 同一 应 用 程序 ， 
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如 模拟 环境 、 生 产 环境 等 。Spring Boot 提供 了 多 种 定制 方法 ， 例 如 属性 文件 、YAML X 
件 、 环 境 变量 以 及 命令 行 参 数 外 部 化 配置 内 容 。 

利用 诸多 属性 ，Spring Boot 可 对 auto-configuration 进行 修改 。 下 面 考查 如 何 利用 
application.properties 文件 修改 Spring Boot 的 属性 值 。 默 认 状 态 下 ，Spring Boot 将 在 这 些 
^. E AbfriE application.properties 〈 按 照 下 列 顺序 : 

Q 工作 目录 的 /config T Hox 


U 工作 目 隶 。 
Q classpath 中 的 config €. 
L] classpath $R. 


我 们 可 根据 此 类 文件 创建 一 个 PropertySource。Spring Boot 中 涵盖 了 大 量 的 配置 属性 。 

下 面 考 但 DataSource Bean 配置 示例 。 在 该 示例 中 ， 将 探讨 如 何 控制 或 修改 Spring 应 
用 程序 中 ，Spring Boot 的 DataSource 默认 配置 。 其 中 ， 较 为 典型 的 配置 内 容 如 下 所 示 : 

”使 用 预定 义 属 性 。 

QD” 修改 底层 数据 源 连 接 池 的 实现 。 

LU ”定义 日 己 的 DataSource Bean. 

这 里 首先 但 看 属性 文件 中 可 配置 的 常见 属性 ， 并 修改 DataSource Bean 的 配置 内 容 ， 
al P Br: 


# Connection settings 


spring.datasource. 
sprimg.datuasource. 
spring.datasource. 


spring.datasource. 


url- 
username- 
password- 


driver-class-name- 


# SOL scripts to execute 


spring.datasource. 


spring.datasource. 


i Connection pool 


spring.datasource. 
spring.datasource. 
spring.datasource. 


spring.datasource. 


可 以 看 到 ， 此 处 需要 针对 DataSource Bean 定义 确定 目 己 的 设置 内 容 ， 例 如 Connection 


schema- 
data- 


settings 


inil ial Sze 
max-active- 
max-1idle- 


min-idle- 
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settings, SQL scripts to execute, Connection pool settings。 但 如 果 存 在 一 个 现 有 的 池 依 赖 
关系 ,Spring Boot 在 默认 状态 下 将 创建 一 个 池 化 的 DataSource Beans 默认 时 ，spring-boot- 
starter-jdbc 或 spring-boot-starterjpa starter 将 个 置 入 tomcat-jdbc 连接 池 中 ; 用 尸 也 可 对 此 进 
行 修 改 ， 并 使 用 Tomcat、HikariCP、Commons DBCP 1 和 2 这 一 类 蔡 代 方案 。 

当 采 用 Spring Boot 属性 时 , 下面 考 查 男 一 个 Web 容器 配置 示例 ， 对 应 的 配置 代码 如 
下 所 示 : 

server.port-9000 

Server nddrezss-i97  |6 1 1 之 | 

server.session-timeout-1800 

server.context-path-/accounts 

server.servlet-path-/admin 

接 下 来 将 考 得 在 通过 和 蔡 换 已 生成 的 Bean 后 ， 如 何 修改 Spring Boot 应 用 程序 中 的 


auto-configuration« 


2.2.2 蔡 换 已 生成 的 Bean 


通过 在 Spring 应 用 程序 中 定义 特定 的 Bean, 还 可 定制 Spring Boot auto-configuration. 
针对 此 类 Bean, Spring Boot 将 不 再 使 用 亚 认 的 配置 。 

一 般 情 况 下 ， 显 式 声 明 的 Bean KH AJEA Bean， 例 如 : 

QBean 

public DataSource dataSource() [| 

return new EmbeddedDatabaseBuilder(). 
setName ("AccountDB").build(t); 

} 

上 述 代 人 码 显 式 地 定义 了 DataSource Bean; DataSource Bean 配置 将 阻止 Spring Boot 
创建 默认 的 DataSource。 这 里 ，Bean 的 名 称 并 不 十 分 重要 ， 并 与 XML 配置 、 注 解 和 /或 
Java 配置 协同 工作 。 

接 下 来 考查 Spring Boot 目 动 配置 的 另 一 种 方式 。 


22.3 茶 用 特定 的 auto-configuration 类 


在 任意 时 刻 ， 如 果 不 和 希望 使 用 茶 些 特定 的 auto-configuration 类 ， 或 者 对 应 类 无 法 满 
正当 前 需求 , 则 可 对 其 加 以 茶 用 。 对 此 ， 可 采用 @EnableAutoConfiguration 注解 的 exclude 
属性 ， 对 应 示例 如 下 所 示 : 
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aEnableAutoConfiguration(exclude-DataSourceAutoConfiguration.class) 


public class ApplrcationContiquration [ 


} 


上 述 代 码 卢 段 使 用 了 市 有 exclude 属性 的 @EnableAutoConfiguration 注解 。 
DataSourceAutoConfiguration 类 将 根据 当前 的 auto-configuration 被 执行 。 关 似 地 ， 可 和 定义 
一 个 需要 执行 的 auto-configuration 类 列表 。 


O 注意: 


可 在 注解 级 别 并 使 用 相关 属性 定义 所 排除 的 内 容 。 


ifii ie Spring Boot 中 男 一 个 auto-configuration 定制 方面 的 内 容 。 
2.2.4 修改 库 的 依赖 天 系 


Spring Boot 根据 starter 的 JAR 包含 了 auto-configuration， 这 体现 在 Spring 应 用 程序 
HJERTE. Spring Boot POM 包含 了 starter 依赖 关系 ， 因 此， 可 在 pom.xml 文件 中 设置 


«properties? 
«spring.version»5.0.0.RELEASE«/spring.version» 
«/properties» 


KERR (例如 既定 版 本 中 的 Bug. REIRI A ERRE ， 可 对 依赖 天 
ABC XETTIÉTAYSAE. TET RS AENDBEUX REIR. HEAR WENE ETERIK 3E 
行 有 效 的 管理 ， 因 而 一 般 情 况 下 ， 应 尽量 避免 修改 应 用 程序 中 的 依赖 关系。 

WREE EHEH F Spring 应 用 程序 ， 则 可 在 Spring 应 用 程序 的 闫 路径 中 对 其 耶 
AHR. AA PIIRAA: 


<dependency> 
<groupId>org.springframework.boot</groupId> 
«artifactId»spring-boot-starter-websocket«/artifactId» 
«exelus1Tons-^ 
«exclusion» 
«groupId»ch.qos.logback«/groupId» 
«artifactlId»logback-classic«/artifactId» 
«/exclusion» 
«/exclusions» 


</dependency> 
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<dependency> 
«groupId»org.slf4j«/groupId» 
«artifactfd^5slE4) log4j]l2</artifactIid> 
</dependency> 
其 中 ， 从 spring-bootstarter-websocket starter 中 排除 了 默认 的 logback 库 ， 并 针对 应 用 
程序 日 志 记 录 加 入 了 1log4j FE. 
接 下 来 讨论 与 Spring Boot 目 定 义 配 置 相关 的 另 一 部 分 内 容 。 


2.3 基于 属性 的 配置 外 部 化 


针对 调 优 操作 ，Spring Boot 提供 了 超过 1000 个 属性 ，Spring Boot 文档 中 提供 了 详细 
的 属性 列表 ， 对 应 网 址 为 https://docs.spring.io/spring-boot/docs/2.0.2.RELEASE/reference/ 
mlsingle/#common-application-properties。 我 们 可 利用 这 些 属 性 调整 Spring MH FEY HJ 
置 ， 并 通过 环境 变量 、Java 系统 属性 、JNDI、 命 令 行 参数 或 属性 文件 指定 相关 属性 。 然 
而 ， 在 修改 此 类 属性 时 ，Spring Boot 也 会 涉及 一 定 的 顺序 ， 以 防止 在 其 上 定义 相同 的 属 
性 。 下 面 考 碍 属性 的 评估 顺序 。 


2.3.1 属性 的 评估 顺序 


属性 的 修改 涉及 以 下 评估 顺序 : 
(1) 主 有 目录 中 ， 人 针对 Devtools 全 局 设置 所 定义 的 属性 。 
(2) 测试 时 ， 针 对 @TestPropertySource 注解 定义 的 属性 。 
(3) 作为 命令 行 参数 的 属性 。 
(4) 根据 SPRING APPLICATION JSON 所 定义 的 属性 。 
(5) 包含 ServletConfig init 参数 的 属性 。 
(6) 包含 ServletContext init 参数 的 属性 。 
(7) JR EI java:comp/env 的 JNDI 属性 。 
(8) Java 系统 属性 。 
(9) 操作 系统 环境 变量 。 
(10) 属性 文件 一 一 包括 application.properties 及 其 YAML 变化 版 本 。 
上 述 内 容 体 现 了 相应 的 优先 顺序 ， 这 也 意味 看 ， 如 末 将 较 局 顺序 优先 级 的 属性 设置 
于 列表 中 ，Spring 将 者 写 列 表 中 优先 级 较 低 的 同一 属性 。 测 试 环 境 和 命令 行 参数 可 稚 写 
源 目 其 他 属性 源 的 属性 。 
下 面 得 看 下 列 属 性 文件 和 YAML 变化 版 本 的 衍化 顺序 : 
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(1) RandomValuePropertySource 类 (该 类 将 包含 随机 值 的 属性 注入 配置 文件 中 ) $E 
义 为 random.*。 
(2) JAR 外 部 的 配置 应 用 程序 属性 。 也 束 古 说 ， 应 用 程序 运行 目 杂 的 于 目录 /config 
(application-{profile}.properties 4ll YAML 变 体 ) 。 


s 二 av 
0 mu E 

通过 执行 包含 参数 Dspring.profiles.active-dev 的 JAR, 或 者 设置 spring.profiles.active-dev 
属性 ， 可 选择 一 个 配置 文件 。 


(3) JAR 外 部 的 配置 应 用 程序 属性 ， 但 位 于 应 用 程序 运行 目录 中 Capplication- 
(profile) properties 和 YAML 4E) 。 
(4) 打包 于 JAR 内 部 的 配置 应 用 程序 属性 ， 但 位 于 名 为 config 的 包 中 Capplication- 
(profile) properties 和 YAML 变 体 ) 。 
(5) 打包 于 JAR 内 部 的 配置 应 用 程序 属性 ， 但 位 于 类 路 径 根 部 Capplication-{profile}. 
properties 4l YAML 变 体 ) 。 
(60 位 于 JAR 外 部 的 应 用 程序 属性 。 也 束 古 说 ， 在 应 用 程序 运行 目 杂 的 /config T 
目录 中 (application.properties 4l YAML 变 体 ) 。 
(7) JAR 外 部 的 应 用 程序 属性 ， 但 位 于 应 用 程序 运行 目录 中 Capplication.properties 
fl YAML 变 体 ) 。 
(8) JAR 内 部 的 应 用 程序 属性 ， 但 位 于 名 为 config 的 包 中 Capplication.properties 和 
YAML 变 体 ) 。 
(9) JAR 内 部 的 应 用 程序 属性 ， 但 位 于 类 路 径 的 根部 Capplication.properties 和 
YAML 变 体 ) 。 
(10) (QConfiguration 类 上 有 的 @PropertySource 注解 。 
(11) 默认 属性 (通过 SpringApplication.setDefaultProperties 加 以 指定 ) 。 
根据 优先 级 顺 厅 ， 当 人 设置 任意 配 前 属性 时 ，application-{profile}.properties 将 会 复 与 
application.properties 文件 中 的 同一 属性 (与 application-{profile}.properties 文件 位 于 同一 
IE. 
再 次 强调 ， 该 列表 定义 为 优先 顺序 表 。 也 天 是 说 ，/config 子 目 录 中 的 application. 
properties 文件 将 履 写 应 用 程序 类 路 径 上 application.properties 文件 中 的 同一 属性 。 
下 面 讨 论 如 何 目 定 义 应 用 程序 属性 文件 的 名 称 〈application.properties) 。 


2.32 mA Spring 应 用 程序 中 的 application.properties 


Spring Boot 并 不 会 强制 我 们 仅 使 用 包含 application.properties 名 称 的 单一 属性 文件 或 
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application.yml, [E] 5X F12 AFA E SRF. Aa, aE FAN AAEH myapp. 


properties: 


package com.dineshonjava.masteringspringboot; 


import org.springframework.boot.SpringApplication; 


import org.springframework.boot.autoconfigure.SpringBootApplication; 


aSpringBootApplication 
public class MasteringSpringBootAppl:ication [ 


public static void main(String[] args) | 
Svysrem.sebLPropertv( spring.-contiq.nadme", "myapp"). 


SpringApplication.run(MasteringSpringBootApplication.class, args); 


} 


EE -- 
O xz. 


属性 文件 名 须 定 义 为 myapp， 而 非 myapp.properties。 如 果 使 用 myapp.properties, XJ 
应 文件 应 命名 为 myapp.properties.properties。 


在 上 述 代码 中 可 以 看 到 ,其 中 使 用 了 myapp.properties 文件 , 而 非 application.properties 
wt 

接 下 来 考查 如 何 通 过 Bean 创建 外 部 应 用 程序 属性 , 以 及 如 何 将 Spring 应 用 程序 注册 
为 属性 文件 。 


24 ”外 部 配置 应 用 程序 属性 


利用 Bean, Spring Boot 可 创建 应 用 程序 属性 的 目 定 义 配 置信 息 , 随后 可 将 这 一 类 Bean 
注册 为 Spring Boot 属性 ， 即 使 用 @ConfigurationProperties。 接 下 来 ， 可 通过 application. 
properties 或 application.yml X- fF Vz Ei ix 46 JB TE . 

关于 与 属性 的 协同 工作 ，Spring Boot 还 提供 了 其 他 奉 代 方案 ， 进 而 可 定义 类 型 安全 的 
Bean， 并 验证 应 用 程序 的 配置 内 容 。 下 面 查 看 针对 容器 Bean 的 @ConfigurationProperties 
注解 应 用 方式 ， 如 下 有 所 示 : 

Q (QConfigurationProperties 注解 将 加 载 外 部 化 的 属性 。 

Q ”如 免 表 绥 车 复 。 
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”数据 成 员 目 动 从 相应 的 属性 中 加 以 设 直 。 
AA FaR]: 


@Component 
@ConfigurationProperties (prefix-"accounts.client") 
public class ConnectionSettings [| 

private String host; 

private int port; 

private String logdir; 


private int timeout; 
// getters/setters 


} 
POJO 定义 了 pplication.properties 文件 中 的 下 列 属 性 : 


accounts.client.host=192.168.10.21 
accounts.client.port-8181 
accounts.client.logdir-/loqgs 


accounts.client.timeout-4000 


我 们 可 将 这 一 类 属性 设置 为 环境 变量 ; 或 者 将 其 指定 为 命令 行 参 数 ， 抑 或 将 其 添加 
全 可 设 曾 配置 属性 的 任意 位 置 处 。 

3j 9b. ^ad Spring W A X Hs JI (EnableConfigurationProperties — 
(Q)ConfigurationProperties ERIAS E E LIF. ERdEXSJI f ()EnableConfigurationProperties 
注解 并 对 其 加 以 局 用 。 

配置 类 中 的 @EnableConfigurationProperties 注解 将 指定 并 目 动 注入 容器 Bean. 4A 
下 列 配置 基文 件 : 


aConfiguration 
aEnableConfigurationProperties(ConnectionSettings.class) 
public class AccountsClientConfiquration [| 

// Spring initialized this automatically 

QGAutowired 

ConnectionSettings connectionSettings; 


QBean 
public AccountClient accountClient() 1 
return new AccountClient( 
connectionSettings.getHost(), 


connectionSettings.getPort(), 
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} 
通常 情况 下 , 该 操作 并 无 必要 一 一 Spring Boot auto-configuration 之 后 的 所 有 配置 类 均 
以 @EnableConfigurationProperties 进行 注解 。 


2.5 基于 日 志 记 录 的 调 优 


志 对 于 应 用 程序 运行 期 内 的 Bug 的 调试 和 分 析 来 说 十 分 重要 。 当 与 早期 Spring 框 

A D) iae 需要 在 应 用 程序 中 显 式 地 配置 日 忘 框架 。 但 Spring Boot 对 多 种 日 专 框 以 
提供 了 文 持 ， 并 可 在 Spring 应 用 程序 中 对 日 志 机 制 进行 定制 和 调 优 。 默认 状态 下 ，Spring 
Boot WLU FAZ- 

Q SLF4J: Hilf (facade) 。 

Q Logback: SLF4J 实现 。 

但 作为 一 类 最 佳 实践 ， 应 在 应 用 程序 中 使 用 默认 的 日 志 机 制 ， 并 在 应 用 程序 代码 中 
使 用 SLF4J 抽象 层 。Spring Boot 26 xz SES H HEZ, Ul Java Util Logging. Log4J 和 
Log4J2. E B5]; 3XNJH— P GERI, xRO np Hb o8 — fb H ER. 


<dependency> 
<groupId>org.springframework.boot</groupId> 
«artifactId»spring-boot-starter-websocket«/artifactId» 
«exclusions» 
«exclusion» 
«groupId»ch.qos.logback«/groupId» 
«artifactlId»logback-classic«c«/artifactId» 
«/exclusion» 
«/exclusions» 
</dependency> 
<dependency> 
«groupId»org.slf4j«/groupId» 
«artifactId»slf4j-10g4j12«/artifactId» 
</dependency> 


根据 上 述 代码 可 知 ， 当 前 正在 使 用 log4j12， 而 非 logback 日 志 框 架 。 下 面 考查 如 何 
在 Spring | HTFEH PRG e H ER. 

SAART, Spring Boot 将 日 记 内 容 输 出 至 控制 台中 ; 除 此 之 外 ， 还 可 将 其 输出 至 轮转 
(rotating) 文件 中 。 对 此 ， 可 在 application.properties 中 指定 某 个 文件 或 路 径 。 考 租 下 列 
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MANR: 


# Use only one of the following properties 


t absolute or relative file to the current directory 


logging.file-accounts.log 


# will write to a spring.log file 
logging.path-/var/log/accounts 


:二 二 
ap Db: 


通过 采用 底层 日 志 框 架 的 配置 文件 ，Spring Boot 还 可 配置 日 志 。 


前 述 内 容 讨论 了 如 何在 Spring Boot 应 用 程序 中 自 定义 日 志 操作 。 下 面 将 讨论 属性 文 
件 的 替代 方案 。 


26 YAML 配置 文件 


在 Spring Boot 应 用 程序 中 ， 作 为 属性 的 一 种 蔡 代 方案 ，SpringApplication 2s n] H z) 
X M YAML. YAML 并 不 是 一 种 标记 语言 ， 而 是 .properties 文件 的 一 种 丛 代 方案 ， 进 而 
可 在 层次 配置 结构 中 定义 属性 。 基 于 YAML 的 Java 解释 器 称 作 SnakeYAML. HT 
当前 类 路 径 上 ， 并 可 通过 spring-boot-starters 自动 添加 至 类 路 径 上 。 


2.6.1 针对 属性 的 YAML 


作为 属性 文件 的 一 次 蔡 代 方案 ，Spring Boot 文 持 基于 属性 的 YAML。 对 于 层次 化 的 
配置 数据 来 说 ，YAML 使 用 起 来 十 分 方便 。Spring Boot 属性 以 分 组 方式 加 以 组 织 ， 如 服 
务 器 、 数 据 库 等 

AE PASTE. 

GL] 在 application.properties 中 : 

database.host = localhost 

database.user = admin 

Q 在 application.yml 中 : 


database: 
host: localhost 


üser- admin 
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接 下 来 讨论 如 何在 单一 YAML 文件 中 定义 多 个 属性 。 
2.6.2 单一 YAML 文件 中 的 多 个 属性 


YAML 文件 可 针对 多 个 属性 包含 相应 的 配置 信息 。 在 单一 YAML 文件 中 ， 我 们 可 定 
义 多 个 属性 。Spring Boot 提供 了 一 个 spring.profiles 键 ， 进 而 表明 何 时 应 用 该 文档 。 下 列 
代码 示例 展示 了 如 何在 单一 YAML 文件 中 定义 多 项 配置 。 


iUsed for all profiles 


logging.level: 


org.springframework: INFO 


t'dev' profile only 


spring.profiles: dev 
database: 
host: localhost 


user: dev 
F'prod' profile only 


spring.profiles- prod 
database: 
host: 192.168.200.109 
user: admin 
在 application.yml Xf Fr, IM spring.profile， 我 们 针对 dev 和 prod E X. T Zu4is Fe vx 
BL. EZP, -RREA B T e 
HAR, 如果 application.properties 和 application. yml 具有 相同 的 优先 级 , application.yml 
"HT PEE EAR S application.properties 中 的 属性 。 
下 面 讨论 如 何在 Spring Web 应 用 程序 中 定制 错误 页 面 。 


2.7 Xt] SL JE] EE FP RH RR ER 


在 程序 的 编写 过 程 中 ， 即 使 是 健壮 的 应 用 程序 ， 错 误 也 在 所 难免 。 因 此 ， 和 定制 错 误 
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页 面 对 于 企业 级 应 用 程序 来 说 十 分 重要 。Spring Boot 应 用 程序 提供 了 默认 的 错误 页 面 ， 
如 图 2.1 所 示 。 
| 2» localhost:8080/hell x W— 


所 Q | © localhost8080/he 


Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing this as a fallback. 


Fri Feb 02 00:47:22 IST 2018 
There was an unexpected error (tvpe-Not Found, status-404). 
No message available 


图 2.1 


针对 既定 状态 码 ， 厂 布 望 使 用 定制 的 错误 页 面 ， 可 同 /error 文件 夹 中 添加 一 个 文件 。 
通过 使 用 静态 HTML, FreeMarker, Velocity. Thymeleaf. JSP 等 ， 还 可 创建 自 定 义 的 错 
误 页 面 。 对 应 文件 的 名 称 为 实际 的 状态 人 码 或 掩 码 。 

在 将 404 映射 为 静态 HTML 文件 时 ， 图 2.2 显示 了 对 应 的 文件 夹 结构 。 


src/ 
+- main/ 
+- java/ 
| + «source code» 
+- resources / 
+- public/ 
+- error/ 
| +- 404.html 


+- «other public assets» 


图 2.2 


可 以 看 到 ，/resource/public/error 目录 下 添加 了 目 定 义 404 IRR CHIC ERE VA UA [I 
404.htmD ， 对 应 的 错误 页 面 输出 如 图 2.3 所 示 。 


作为 自动 配置 的 一 部 分 ，Spring Boot 现在 显示 一 个 定制 的 错误 页 面 ， 而 不 是 默认 的 
WhiteLabel £5 ix U1 [Rl] 
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2» localhost:8080/hell x W—3 


€ C localhost8080/hell 


It is custom error page with error code 404 


Oops! We couldn't find this Page. 


Please check your URL or use the search form below. 


图 2.3 


28 A x€* pa 


Spring Boot 可 处 理 Spring 应 用 程序 中 所 需 的 样板 代码 配置 。 自 动 配置 可 被 覆 写 或 禁用 ; 
相应 地 ， 框 染 版 本 也 可 被 宪 写 。 授 过 及 用 属性 /YAML 文件 ，Spring Boot 改善 了 Spring 配置 
外 部 化 机 制 。 其中， 可 通过 属性 和 YAML 文件 方便 地 窗 写 Spring 的 auto-configuration 项 。 

Spring Boot 提供 了 日 志 框 架 的 调 优 机 制 , 进而 可 从 应 用 程序 中 排除 某 些 默认 的 框架 。 
此 外 ，Spring Boot 还 可 对 简单 的 WhiteLabel 错误 页 面 进 行 目 动 配置 。 

第 3 章 将 讨论 Spring Cloud 以 及 Spring CLI 的 安放 过 程 。 


第 3 章 Spring CLI 和 Actuator 


前 述 章 和 讨论 了 创建 Spring Boot 应 用 程序 的 多 种 方式 ， 包 括 Spring Boot Web 界面 、 
STS IDE 和 Spring Boot CLI。 本章 将 深入 讨论 Spring Boot CLI, 同时 还 将 展示 如 何在 机 器 
中 安装 Spring Boot CLI， 以 及 如 何 骨 过 CLI 界面 创建 Spring Boot 应 用 程序 。 
在 疯 旋 完 本 草 后 ， 访 者 能 够 更 加 方便 地 安 闻 、 使 用 Spring Boot CLI， 并 理解 如 何 通 
过 CLI 运行 应 用 程序 。 此 外 ， 我 们 还 将 学 习 Spring Boot 的 生产 环境 特性 ， 即 Actuator. 
Spring Boot Actuator 提供 了 多 个 新 点 ， 进 而 对 生产 环境 中 的 应 用 程序 加 以 考查 。 
本 章 主要 涉及 以 下 主题 : 
D ”开始 使 用 Spring Boot CLI. 
> 安装 Spring Boot CLI. 
a 使 用 Spring Boot CLI Initializr. 
Qd Spring Boot Actuator: 
> 获取 应 用 程序 信息 。 
在 应 用 程序 中 局 用 Spring Boot 的 Actuator- 
分 析 Actuator 的 端点 。 
显示 配置 细节 内 容 。 
TZR 5E ER if e o 
显示 应 用 程序 信息 。 
天 闭 应 用 程序 。 
> 定制 Actuator ii i - 
D Actuator m 53H) Zc 4E TE « 
d JT Spring Boot 2.X 的 Actuator- 
下 面 将 对 此 加 以 逐一 讨论 。 


YYY Y Y Y 


3.1 使 用 Spring Boot CLI 


Spring Boot 提供 了 两 个 接口 ， 即 ApplicationRunner 和 CommandLineRunner. 
顾名思义 ，Spring Boot CLI 是 男 一 个 命令 行 原型 设计 工具 ， 并 以 速度 和 简洁 性 而 车 
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Wk. ZAM. Spring 是 一 类 Java MLHITEHFTEAS, F WT Java 社区 、Java 应 用 程序 以 及 
Web 应 用 程序 构建 中 。 

Spring Boot 可 方便 地 创建 功能 强大 的 Spring 应 用 程序 和 服务 。Spring Boot CLI 可 辅 
助 执行 Spring Boot 创建 的 应 用 程序 和 服务 。Spring Boot CLI 不 必 与 Spring Boot IDE 协同 
使 用 ; 但 若 二 者 结合 使 用 ， 将 会 提升 Spring 应 用 程序 的 执行 速度 。Spring Boot CLI 可 独 
并 和 存在 ， 且 不 需要 运行 任何 其 他 平台 。 

Spring Boot CLI 为 开发 Spring 应 用 程序 提供 了 一 各 有趣 但 非常 规 的 方法 。 下 面 讨论 
如 何 安 装 Spring Boot CLI， 进 而 运行 第 1 章 中 的 示例 代码 。 


3.1.1 安装 Spring Boot CLI 


Spring 提供 了 多 种 方式 可 安 闻 Spring Boot CLI， 只 体 如 下 : 

从 下 载 文件 中 手动 安 疫 。 

利用 SDKMAN! 进 行 安 装 。 

利用 OSX Homebrew 进行 安装 。 

MacPorts 安装 。 

D 命令 行 安装 。 

楼 下 来 将 对 每 种 安装 选项 加 以 讨论 。 首 先是 从 安装 文件 中 手动 安装 Spring Boot CLI 


3.1.2 ”从 安装 文件 中 手动 安 汶 Spring Boot CLI 


LLLL 


FH P n] A Spring Framework 的 官方 网 站 中 下 载 Spring Boot CLI， 如 下 所 示 : 

JW  https://repo.spring.10/snapshot/org/springframework/boot/spring-bootcli/2.0.0.BUIL 
D- SNAPSHOT/spring-boot-cli-2.0.0.BUILD-SNAPSHOT-bin.zip. 

Qd  https://repo.spring.10/snapshot/org/springframework/boot/spring-bootcli/2.0.0.BUIL 
D- SNAPSHOT/spring-boot-cli- 2.0.0.BUILD-SNAPSHOT -bin.tar.gz. 

上 还 着 氮 握 供 了 CLI 的 手动 安装 文件 ， 在 下 载 完 侍 后 ， 其 中 包 人 洛 一 个 名 为 
INSTALL .txt 的 文本 文件 。 该 文件 描述 了 Spring Boot CLI 的 安装 步骤 。 简 而 言 之 ， 
bin/directory 中 包含 了 一 个 可 执行 的 Spring 脚本 。 其 中 ,Spring.bat 适用 于 Windows 用 户 ， 
而 Spring 脚本 则 用 于 UNIX 用 户 。 

Spring Boot CLI 运行 时 需要 使 用 到 Java JDK v1.8 或 更 高 版 本 。 另 外 ， 运 行 CLI 并 不 
需要 使 用 到 特定 的 环境 变量 。 但 是 ， 可 能 需要 设置 SPRING HOME 以 指 癌 特定 的 安装 ; 
此 外 ， 还 应 癌 PATH 环境 变量 中 添加 SPRING HOME/bin。 
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当 测 试 是 否 成 功 地 安装 了 CLI 时 ， 可 运行 下 列 命令 : 
spring --version 


对 应 结 采 如 图 3.1 所 示 。 


图 3.1 


图 3.1 在 Command Prompt E 57s f Spring Boot CLI 的 版 本 。 
这 也 是 一 种 较为 简单 、 目 然 的 Spring Boot CLI 安装 方式 ， 且 无 须 使 用 更 多 的 配置 。 
除 此 之 外 ，Spring 社区 还 提供 了 安装 Spring Boot CLI 的 其 他 方法 ， 下 面 对 此 予以 查看 。 


3.1.3 ”使 用 SDKMAN!ZE Spring Boot CLI 


PPAR IREI SDKMAN!, BÜEXTEJEAR LR VERS, LÁ ERABRE 
制 SDK 版 本 (如 Groovy) 时 , 可 采用 这 种 方法 。 对 此 , 可 访问 sdkman.io 获取 SDKMAN!, 
并 于 随后 利用 第 一 个 链接 中 的 命令 安 闻 Spring Boot CLI。 

对 于 Linux 环境 ， 可 使 用 下 列 命令 : 

S curl -s get.sdkman.io | bash 

ff SDKEMAN z Rm Eja, Biüupaefr FIMA 223€ Spring Boot CLI: 


$ sdk install springboot 
$ spring --version 


3.1.4 利用 OSX Homebrew 安装 Spring Boot CL I 


对 于 Mac 用 户 ， 可 使 用 Homebrew 进行 安装 。Homebrew 是 一 个 针对 macos 的 包 管 
理 系 统 ， 如 下 所 示 : 

S brew tap pivotal/tap 

S brew install springboot 


Homebrew 将 把 Spring 安装 人 至 /usr/local/bin 路 径 中 。 
1. MacPorts 安装 
对 于 Mac 机 器 ， 可 设置 Spring Boot CLI 并 使 用 MacPorts， 这 也 是 macos X 较为 流 
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行 的 安装 程序 之 一 ,站 先 ,可 访问 https://www.macports.org/ 并 根据 Mac 版 本 安装 MacPorts。 
f MacPorts 安 疼 完毕 后 ， 可 通过 以 下 方式 安 妆 Spring Boot CLI， 如 下 所 示 : 

S sudo port install spring-boot-cli 

MacPorts 将 把 Spring Boot CLI Z3 /opt/local/share/java/spring-boot-cli 中 ， 并 在 
/opt/local/bin 中 设置 一 个 符号 链接 一 这 在 安装 MacPorts 时 已 存在 于 系统 路 径 中 。 另 外 ， 
通过 检查 安装 版 本 ， 还 可 进一步 验证 安装 结果 ， 如 下 所 示 : 

$ spring -version 

该 命令 将 显示 Spring Boot 的 版 本 号 。 

2. 命令 行 补 齐 方法 

对 于 Linux 操作 系统 ， 可 采用 命令 行 补 齐 方法 。 此 处 必须 提供 名 为 Spring 的 脚本 ， 
BI zs HS PNIS, bash. Œ Debian 系统 中 ， 这 一 关 脚 本 位 于 /shell-completion/bash 
目录 中 。 此 外 ， 该 目录 中 的 全 部 脚本 可 在 初始 化 Shell 时 加 以 使 用 。 


32 使 用 Initializr 


除 此 之 外 , 还 可 使 用 Spring Boot CLI 中 的 Spring Initializr, 并 提供 了 局 用 开 友 坏 境 的 
一 些 命令 。 其 中 ，Spring Boot CLI 包含 了 一 个 init 命令 ， 进 而 创建 一 个 Spring Boot 应 用 
程序 结构 ， 同 时 可 作为 Spring Initializr 的 客户 站 界面 。 下 列 命令 通过 init 方法 创建 一 个 
Spring Boot WH: 


$ spring init 


init 命令 的 输出 结果 如 图 3.2 Pr. 


D:*packt-book-vuorkspace?spring init 
Using seruice at https:/^/start.spring.io 


Content saved to 'demo.zip' 
D:*packt-book-uorkspace?. 


图 3.2 
在 图 3.2 中 可 以 看 到 ， 这 里 生成 了 一 个 demo.zip 文件 ， 并 保存 至 当前 工作 区 中 。 当 
解压 谣 项 目 文 件 时 ， 将 会 看 到 包含 Maven pom.xml 构建 规 苑 的 典型 项 目 绩 构 。 随 后 ， 可 
FRES Maven 规范 以 及 较 少 配置 的 项 目 ， 并 对 其 进行 测 弃 。 
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实际 上 上， 如果 希望 使 用 Spring MVC 创建 一 个 Web 应 用 程序 ， 并 使 用 JPA 实现 数据 
持久 性 ， 则 可 采用 下 列 命 令 ， 其 中 包含 了 全 部 所 需 的 应 用 程序 依赖 关系 。 

$ spring init -dweb, jpa 
LES 

可 利用 --dependencies 或 -d 指定 初始 依赖 关系 。 

上 述 命令 同时 生成 了 demo.zip 文件 ， 其 中 包含 了 相同 的 项 目 结构 ， 同 时 也 涵盖 了 作 
7J pom.xml 中 依 顿 关系 加 以 表示 的 、Spring Boot 的 Web 和 JPA JH 22s». AE 3.3 所 示 。 


D:*«packt-spring-boot-us?spring init -dweb.jpa 


Using seruice at https-//start.springy.1io 
Content saved to 'demo.zip' 
D:**packt-spring-boot-ws? 


vi IE 
0 LEER: 


-d 和 依赖 项 之 间 不 要 输入 空格 。 


可 以 看 到 ， 此 处 开 未 定义 任何 构建 规 匈 ;默认 状态 下 包含 了 Maven HERG. WR 
ABJA Gradle 构建 规范 ， 则 需要 使 用 下 列 命令 : 


spring init -dweb,jpa --build gradle 


该 命令 利用 --build 参数 将 Gradle 作为 构建 类 型 ， 如 图 3.4 所 示 。 


D:*packt-spring-boot-ws?»spring init —dueb.jpa —-—-build gradle 
Using service at https:/^/start.spring.1io 


Content saved to 'demo.zip' 
D:*packt-springy-hboot-ws?. 


图 3.4 


=H, demo.zip 文件 保存 全 基于 Gradle ÆN (MAE Maven) 的 工作 目录 中 。 此 
外 ,在 默认 条 件 下 ,基于 Maven 或 Gradle 构建 规范 的 demo.zip 项 目 将 生成 可 执行 的 JAR 
文件 。 如 果 打 算 生 成 WAR 而 非 JAR， 则 可 在 下 列 命令 中 指定 多 个 参数 。 


S spring init -dweb,jpa --build gradle -p war 
O 注意; 

也 可 采用 --packaging 或 -p 参数 指定 文件 类 型 。 

对 应 的 输出 结果 如 图 3.5 所 示 。 
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D:spackt-spring-boot—-us?spring init —dwveb.jpa --build gradle -p war 
sing service at https:/^/start.spring.io 


Content saved to 'demo.zip' 
D:*packt-spring-boot-ws? 


图 3.5 
通过 下 列 命 令 ， 还 可 了 解 其 他 参数 的 用 途 。 
$ spring help init 


对 应 结果 如 图 3.6 所 示 。 
sage: spring init [options] [location |] 
Opt ion 


ra. ——artifactld Project coordinates; infer archive 
name for example 'test'» 
hb. ——-hoot-version Spring Boot version &for example 
!1.2.B.RELERSE' > 
—-—-huild Build system to use &for example 
'mauen' or 'gradle'» default: maven)? 
-d. ——-dependencies  Comma-separated list of dependency 
identifiers to include in the 
generated project 
—description Project description 
—-f. ——force Force ouerurite of existing files 
——tormat Format of the generated content &for 
example 'hbuild' for a build file, 
^project' for a project archive» 
Cdefault: project? 
——qroupId Project coordinates &for example 
test'» 
——Jaua-uersion Language level for example '1.8'» 
—— language Programming language 《for example 
! java’? 
——name Project name; infer application name 
——packaginsgj Project packaging <for example 'Jjar'?» 
Package name 
Project type. Mot normally needed if 
you use ——huild and/or —-format. 
Gheck the capabilities of the 
service €—-list?» for more details 
URL of the seruice to use &default: 
https://start.spring.io»? 
Project version &for example 'BH.H.1— 
SNAPSHOT” > 
Extract the project archive. Inferred 
if a location is specified without 
an extension 


^or. 


To list all the capabilities of the service: 
|^ Spring init -—-1list 


lo creates a default project: 
$ spring init 


To create a web my-app.zip- 
spring init —d-veb my-app.zip 


lo create a ueb/data-jpa gradle project unpacked: 
$ spring init -d=web. ipa —-build-qradle mvu-dir 
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在 init 命令 中 ， 通 过 --list 参数 ， 还 可 进一步 考查 参数 的 选项 ， 如 下 所 示 : 


$ spring init -list 


除了 Spring Boot CLI init 命令 可 用 于 创建 Spring 项 目 之 外 ,Spring 社区 还 提供 了 Web 
Zt]. Spring Tool Suite 或 Spring Boot CLI 初始 化 Spring Boot 项 目 。 

其 中 ，Spring Boot CLI 无 须 指定 构建 规范 。CLI 从 代码 中 获取 提示 信息 ， 处 理 依赖 关 
RHEA. Spring Boot CLI 可 生成 几乎 完美 的 部 普 体 验 ， 并 可 消除 所 有 的 代码 
改 障 。 

在 安装 结束 后 ， 即 可 运行 简单 的 应 用 程序 (参见 第 1 章 ) 。 对 此 ， 需 要 使 用 相同 的 
Web 应 用 程序 ， 即 app.groovy， 如 下 所 示 : 


aRestController 
class HelloController | 
QGetMapping ("/") 
String hellot) { 
return "Hello World!!!" 
} 
} 


随后 ， 将 该 文件 保存 为 app.groovy， 并 通过 下 列 命令 运行 在 Shell 中 运行 当前 应 用 
程序 。 
$ spring run app.groovy 


EA vi 2873] JF http:/localhost:8080/。 如 果 输 出 结果 为 Hello World， 或 者 其 他 应 用 
程序 请 求 任 务 ， 即 表明 安 逆 过程 顺利 完成 。 

在 运行 了 上 述 命 令 后 ， 考 查 如 图 3.7 所 示 的 显示 结果 。 其 中 ,控制 台 的 第 1 行 代码 用 
于 处 理 依赖 关系 ， 但 当前 应 用 程序 并 未 定义 依赖 项 。Spring Boot CLI 根据 应 用 程序 所 编 
写 的 类 目 动 处 理 依赖 关系 ; 但 也 可 定义 显 式 库 依赖 关系 ， 即 使 用 @Grab 注解 。 下 面 考查 
应 用 程序 中 HSQL 数据 库 的 @Grab 注解 ， 并 通过 Spring Boot CLI 运行 该 应 用 程序 ， 如 下 
所 不 : 


aGrab("HSQL") 


13] 98, "P ERAI e s AR IAS 3.8 Brzn 
可 以 看 到 ，Spring Boot CLI 提供 了 快速 的 开发 方式 。 
下 面 讨 论 另 一 个 重要 的 特性 ， 同 时 也 是 Spring Boot 的 核心 组 件 。 
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D:*packt-spring-boot-vus*sapp?»spring run app.groouyu 
Resolving TT ri o ocu qYsRwWEWYERWELAMN RS KV E uVEQeEds wea EEENEENEW á 


(v2.8.8. BUILD-SNaPSHOT? 


2018-02-64 B : H3 : 12. 631 INFO 5888 一 一 一 L runner-Hl o.s.boot.SpringHpplicat 
ion Starting application on MRNDIHTIMOBLBEBBZ with PID 5888 start 
ed by Dinesh. Rajput in D:*packt-spring-boot-us*app? 
-643 INFO 5888 -—— L runner-Hl o.s.boot.SpringHpplicat 
Ho active profile set, falling back to default profiles: def 


t 
2018-02-64 00:63:20.243 INFO 5888 -— I runner—-Hl GConfigServuletlebSeruverf 
pplicationContext : Refreshing org.springframeuork.boot .web.serulet.context.finno 
tationConfigSeruletUebServerfipplicationContext(449e5e'793: startup date [Sun Feb Ø 
4 00:03:20 IST 20181; root of context hierarchy 
2018- 82-84 BHB8:83:22.855 INFO 5888 -— I runner- ] o.s.b.w.embedded.tomcat 
.lomcatlehbSeruer =: Iomcat initialized with port<s): 888H Chttp»o 
2018-82-84 WHH:H3:22.878 INFO 5888 -—— [ runner-Hl o.apache.catalina.core. 
StandardSeruice : Starting service [Tomcat] 
2018—-H2-H4 HB:H83:22.878 INFO 5888 一 一 一 L runner-Hl org.apache.catalina.cor 
e.otandardEngine : Starting Serulet Engine: Apache Tomcat/8.5.2? 
2018—-H2-84 66:03:22.902 INFO 5888 一 一 [ost-startStop-1] o.a.catalina.core.flprLi 
fecycleListener = Ihe HPH based Apache Tomcat Native library which allows opti 
mal performance in production environments was not found on the jJava.library.pat 
h: [C:\Program Files*Java*jdk1.8.B8 121*«bin;G:Uindous*Sun*Jaua*bin;G:*Mindows'*ssy 
stem32;C:Mindous;C: *sPraogramData*Oracle*Jaua*jauapath;G- Program Files &xS86»«Int 
el\iCLS Glient*;C-:XProgram Files*Intel«*«iCLS Client*;GC-:Uindows*sustem325;0C:XMaindo 
2.6: “Windows“Suvstem32\Whem;C: “Windows\Sustem32\WindowsPowerShell\v1. HM; C:N Progr 

am Files*Intel*«Intel«R» Management Engine GComponents*«DHüL;GC:«Program Filessintels 
IntelcR5 Management Engine Components MXIPT;G:*«Program Files &x86»5«Intel*«IntelcR» 
Management Engine Gomponents*XDARL;C:*«Program Files &x86»5*«Intel*«Intel&H» Managemen 
t Engine Components*«IPT;GC:«Program FPiles*Intel*WViFi*bin*;C:.Program Piles*Common 

Files*Intel*UirelessGommon*;GC:«Program Files &x86»5Mindous Livue*Shared;GC:*.Progr 
am Files*Git'*cmd;G:*Program Files CxB6»*Skupe*Phones;D:*«personal datawmaven*bin; 
C: “Program Files*Jaua*Xjdki1.8.B8 121bin;G:'.Program Files“Docker Ioolbox;D:5person 
al data*book*Mastering Spring Boot 2.B8*«spring-2.8.8.BUILD-SNAPSHOT*bin;. 1 
2018- 82-84 BB:H3:23.586 INFO 5888 ——— [ost-startStop-11] org.apache.catalina.loa 
der.WVebappLoader : Unknown loader orgy.springframevork.boot.cli.compiler.Extende 
dGroovyGlassLoader$DefaultScopeParentClassLoader(1f5f815d class org.springframeu 


- - E] "Leo 
localhost:S080 


= 《> |G) localhost 


Hello World!!! 


图 3.8 
3.3 Spring Boot Actuator 


读者 是 否 曾 考虑 过 Spring 应 用 程序 在 生产 环境 中 的 状况 ? 例如， 创建 了 多 少 个 对 
R? 内 存 使 用 率 如 何 ? 如果 框架 多 许 参 看 全 部 数据 信息 ， 用 户 即 可 在 生产 环节 中 通过 
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HTTP Ji sk JMX 管理 应 用 程序 。 据 此 ， 我 们 可 了 解 应 用 程序 的 行为 方式 ， 并 对 其 健康 
状态 进行 检测 。 

本 节 将 介绍 Spring Boot 的 一 个 核心 组 件 Actuators Spring Boot Actuator 可 监视 生产 
环境 下 的 某 些 特性 ， 例 如 Spring 应 用 程序 的 一 些 指 标 和 健康 状态 。 

Spring Boot Actuator 是 Spring Boot 的 一 个 子 项 目 , 其 中 涉及 较 多 的 功能 。 利 用 Spring 
Boot Actuator, 用 户 可 更 加 高 效 地 控制 应 用 程序 的 灵敏 度 和 安全 性 。 一旦 局 用 了 Actuator, 
应 用 程序 中 的 指标 、 输 入 流量 以 及 数据 库 的 状态 监控 将 变 得 十 分 简单 。Spring Boot 
Actuator 的 主要 优点 体现 在 : 它 是 一 种 生产 级 别 的 工具 ， 用 户 无 须 实现 其 中 的 菜 些 特性 。 

接 下 来 讨论 如 何在 Spring 应 用 程序 中 局 用 这 些 生产 环境 中 的 特性 。 


3.3.1 ”在 应 用 程 友 中 局 用 Spring Boot Actuator 


当 在 应 用 程序 中 司 用 Spring Boot Actuator 时 ， 需 要 在 包 管 理 亏 中 谎 加 Spring Boot 
Actuator 依赖 天 系 ， 这 也 十 在 Spring 应 用 程序 中 局 用 生产 环境 特性 的 最 为 向 单 的 方式 ， 
即 添加 starter 依赖 项 spring-boot-starter-actuator. 

在 Spring 应 用 程序 中 ， 下 面 将 Actuator 添加 至 Maven 项 目 中 。 

<dependencies> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-actuator«/artifactld» 
</dependency> 

</dependencies> 

上 述 Maven 脚本 将 局 用 生产 环 场 中 的 特性 。 下 面 考查 如 何 司 用 包含 Grade 项 目的 
Actuator- 

考 得 下 列 声 明 内 容 : 

dependencies { 


compile("org.springframework.boot:spring-boot-starter-actuator") 


| 


该 Gradle 脚本 将 启用 Spring 应 用 程序 生产 环境 中 的 特性 。 
在 局 用 了 生产 环境 特性 后 ， 接 下 来 讨论 Spring Boot Actuator 提供 的 新 点 。 


3.3.2 分析 Actuator 的 端点 


Spring Boot Actuator 所 供 了 多 个 Web 冰点 ， 可 监视 处 于 运行 状态 下 的 应 用 程序 ， 并 
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可 三 看 生产 环境 下 应 用 程序 的 内 部 行为 。Spring Boot Actuator 针对 Spring 应 用 程序 提供 
了 多 个 预定 义 端 点 ， 此 外 ， 还 可 加 入 自 定 义 的 端点 ， 进 而 监视 生产 环境 下 的 应 用 程序 。 

例如 , 健康 的 端点 提供 了 基本 的 应 用 程序 健康 状态 信息 ; 除 此 之 外 , 还 可 以 了 解 Bean 
在 Spring 应 用 程序 上 下 文中 是 如 何 连 接 在 一 起 的 ， 确 定 应 用 程序 的 有 效 环 境 属 性 ， 获 取 
运行 期 指标 的 快照 等 。 

如 条 应 用 程序 通过 Spring Boot Actuator 进行 配置 ， 用 户 可 方便 地 使 用 应 用 程序 ， 并 
通过 调用 HTTP 端点 对 其 进行 优化 。Spring Boot Actuator 支持 范围 较 广 的 HTTP 端点 ， 
如 下 所 示 : 

QD Bean 详细 信息 。 

E 志 记 录 详 细 信 息 。 

口 ”配置 详细 信息 。 

D ”健康 状态 详细 信息 。 

口 ” 版 本 详细 信息 。 

在 Spring Boot Actuator P] £m AAE mi E, Actuator 还 可 添加 目 己 的 靖 点 ， 或 者 对 
MA Him ATAT H ENERE. Spring Boot 针对 东 些 HTTP mA RA AAEE., Al 
而 无 法 公开 显示 ， 这 一 类 端点 需要 使 用 到 密码 或 者 用 户 名 。 

Spring Boot Actuator 可 通过 多 种 方式 显示 冰点 ， 但 这 取 雇 于 所 使 用 的 扩 术 。 一 旦 应 
用 程序 配置 1 Spring Boot Actuator， 即 可 提供 多 个 Actuator REST mo WREE S HTTP 
Web 9m ki, Dünpexxm sue. Br E. 


表 3.1 
REST 端点 "n 
它 提 供 了 一 个 发 现 平 台 来 代 蔡 其 他 端点 的 页 面 。 当 局 用 Actuator 时 ， 需 要 在 类 路 径 上 
/actuator 设置 Spring HATEOS。 默 认 状 态 下 ，Actuator 包含 了 敏感 数据 ， 因 而 需要 使 用 到 密码 


或 用 户 名 :; 或 者 由 于 Web 安全 性 被 禁用 ， 因 而 Actuator 也 处 于 禁用 状态 

/auditevents | 全 部 审计 信息 和 事件 均 包 含 于 该 端点 中 

/autoconfig 针对 应 用 程序 中 所 用 的 目 动 配置 ， 提 供 了 目 动 配置 报告 
显示 了 配置 于 应 用 程序 中 的 所 有 Bean。 对 于 Spring 中 配置 的 应 用 程序 ，Bean T 2r 5 
要 ， 同 时 也 是 在 Spring IoC 容 右 中 可 被 初始 人 化、 组装 和 省 理 的 对 

/configprops | 显示 了 config 属性 的 细节 信息 


/beans 


/dum 用 于 转 储 线程 
/env 显示 了 Spring 中 可 配置 环境 的 不 同属 性 


/flywa 可 辅助 查看 数据 库 迁 移 结 果 


第 3 草 Spring CLI 和 Actuator * 5] 
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REST 端点 Hoo xh 

"m 显示 了 应 用 程序 健康 状态 信息 。 健 康 状态 信息 包括 安全 性 、 连 接 的 号 份 验 证 ， 以 及 应 
用 程序 身份 验证 的 消 姑 细节 

/info 应 用 程序 信息 

/loggers 可 以 此 显示 或 更 改 应 用 程序 中 不 同日 志 记 录 髓 的 配置 

/liquibase 但 看 liquibase 的 迁移 结果 

/metrics 显示 应 用 程序 的 指标 信息 

/mappings 显示 应 用 程序 中 整个 请 求 映 射 路 径 的 队列 

Á— 可 通过 更 为 优雅 的 方式 关闭 程序 。 默 认 状 态 下 ，Spring Boot 该 项 处 于 禁用 状态 。 用 户 
可 在 必要 时 对 其 加 以 局 用 

/trace 显示 跟踪 数据 〈 时 间 惟 、 头 信息 等 ) ， 其 中 涉及 100 个 最 新 的 HITP 请 求 

表 3.1 显示 了 多 个 Web 端点 ;相应 地 ， 可 将 此 类 端点 分 组 至 以 下 3 个 类 别 中 : 


Q BOE. 

Q  djübs o 

D MHE 8 sli F3 e 

rim ER ERR Em MEIRA Y REMH TEF AA SAE 


息 。 考 虑 到 端点 可 能 


会 包含 敏感 信息 ， 因 而 在 其 显示 过 程 中 应 齐 慎 处 理 。Spring Boot 将 通过 JMX 公开 所 有 局 


用 的 端点 ， 但 只 显示 了 HITP 上 的 health 和 info 端点 。 


3.33 显示 配置 细节 


Spring Boot Actuator j£ E f JE Ueym ri, nf Spring 应 用 程序 配置 的 细节 信息 。 这 


些 疹 点 提供 了 所 有 已 配置 Bean 的 详细 信息 , 以 及 在 填充 Spring 应 用 程序 上 下 文 时 自动 配 


阐 所 做 的 决 案 。 和 下面 合 看 一 下 应 用 程序 Spring 上 和 下文 最 重要 的 交点 ， 
冰点 返回 JSON 形式 的 信息 ， 如 下 所 示 : 


[ 

{ 

context: "application", 

parent: null, 

beans: 

[ 

{ 

bean: "springBootActuatorApplication", 


scope: "singleton", 


Hl/beans Jm L4. 


该 
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type: 
"com.dineshonjava.sba.SpringBootActuatorApplication$$EnhancerBySpring 
CGLIBS 

See8dcó6d9", 

resource: “null”, 

dependencies: [ ] 

), 

1 

bean: 
"Oorg.springframework.boot.autoconfigure.internalCachingMetadataReader 
Factory", 

scope: "singleton", 

Lype: 
"Oorg.springframework.core.type.classreading.CachingMetadataReaderFactory", 
resource: “null?, 

dependencies: [ ] 

Fr 

{ 


bean: "loginService", 

scope: "singleton", 

| m x E a ip TT 
type: "com.dineshonjava.sba.LoginService", 


resource: "file [D:/packt-spring-boot-ws/SpringBootActuator/target/classes/ 
com/dineshonjava/sba/LoginService.class]", 

dependencies: 

[ 

"ecounterSerwice" 

] 

), 

{ 

bean: "myCustomEndpoint", 

scope: Tsingleton™", 

type: "com.dineshonjava.sba.MyCustomEndpoint", 

resource: "file [D:/packt-spring-boot-ws/SpringBootActuator/target/classes/ 
com/dineshonjava/sba/MyCustomEndpoint.class]", 


dependencies: [ ] 


AER, fE/beans mAH JSON 数据 中 ， 应 用 程序 中 的 全 部 配置 Bean HES f 5 
其 相关 的 下 列 信 息 。 

D Bean: 表示 为 Spring 应 用 程序 中 配置 Bean 的 名 称 或 ID. 

L] Dependencies: 表示 为 Bean ID 列表 。 
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L] | Scope: Bean 的 范围 。 

Q Type: Bean 的 Java 类 型 。 

/beans 显示 了 配置 在 应 用 程序 中 的 所 有 Bean. Bean 对 于 在 Spring 上 配置 的 应 用 程序 
来 说 十 分 重要 ， 同 时 也 是 在 Spring IoC 容器 中 被 初始 化 、 组 装 和 管理 的 对 象 。/autoconfig 
疹 点 提供 了 目 动 配置 报告 .Spring Boot 目 动 配置 构建 于 Spring 条 件 配置 之 上 .另外 ,Spring 
Boot JEH T € 8.15 (à) Conditional EMAR. vZ(a)Conditional 注解 决定 Bean Æ fM 
被 自动 配置 。 下 面 考查 /autoconfig "m AEH FY JSON 数据 。 


{ 

positiveMatches: 

{ 

AuditAutoConfigurationfauditListener: 

[ 

{ 

condition: "OnBeanCondition", 

message: "àConditionalOnMissingBean (types: 
org.springframework.boot.actuate.audit.listener.AbstractAuditListener; 
SearchStrategy: all) found no beans" 

} 

lz 

AuditAutoConfigurationdauthenticationAuditListener: 

[ 

1 

condition: "OnClasscondition", 

message: "GConditionalOnClass classes found: 
org.springframework.security.authentication.event.AbstractAuthenticati 
onEvent" 

b, 

{ 

condition: "OnBeanCondition", 

message: "àConditionalOnMissingBean (types: 
org.springframework.boot.actuate.security.AbstractAuthenticationAudit 


Listener; SearchStrategy: all) found no beans" 


] ， 

negativeMatches: 

{ 
CacheStatisticsAutoConfiguration: 
[ 

{ 
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condition: "OnBeanCondition", 

message: "àConditionalOnBean (types: 
org.springframework.cache.CacheManager; SearchStrategy: all) found no beans" 
} 

] ， 
CacheStatisticsAutoConfiguration.CaffeineCacheStatisticsProviderConfig 
uration: 

[ 

{ 

condition: "OnClassCondition™, 

message: "required G8ConditionalOnClass classes not found: 
com.github.benmanes.caffeine.cache.Caffeine,org.springframework.cache. 
caffeine.CaffeineCacheManager" 

Fx 

| 

condition: "ConditionEvaluationReport.AncestorsMatchedCondition", 
message: "Ancestor 
'org.springframework.boot.actuate.autoconfigure.CacheStatisticsAutoCon 


frguration' did not match" 


上 述 JSON 内 容 表 示 为 /autoconfig 的 输出 结果 ， 该 JSON 分 为 两 部 分 ， 即 
positiveMatches 和 negativeMatches。 其 中 ，negativeMatches 下 的 数据 表示 存在 一 个 条 件 ， 
进而 确定 是 否 配置 Bean。positiveMatches 则 表示 将 获取 某 个 条 件 以 确定 Spring Boot 是 否 
应 自动 配置 Bean. 

下 耐 考查 男 一 个 配置 问 点 /env， 该 新 点 显示 了 Spring 中 所 有 可 配置 环境 的 不 同属 性 ， 
Ul hr: 


| 

和 |， 

server.ports: 1 

local.server.port: 8080 

} ， 

commandLineArgs: { 
spring.output.ansi.enabled: "always" 
t; 

servletContextInitParams: { }, 
systemProperties: 1 


sun-boot Irbrary-path- "C:Program kilesJavajrel.8-0 lo en 
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]Jawa-wm.version- "25.1531-b12 5, 
Jawva.vm.vendor: "Oracle Corporation", 
java.vendor.url: "http://java.oracle.com/", 
jJava.rmi.server.randomIDs: "true", 
path.separator: "ri, 


java.vm.name: "Java HotSpot (TM) 64-Bit Server VM", 
frle.encoding.pkg: "sun-i1o', 
user.name: "Dinesh.Rajput", 
com.sun.management.jmxremote: "", 

java.wn.spocifticuatdon.versrton; "I.98", 

sun.java.command: "com.dineshonjava.sba.SpringBootActuatorApplication -- 
spring.output.ansi.enabled-always", 

java.home: “C:Program Rirlesdavajgrel-8.0 1517, 

sun.atrch.data.model: "64", 

sun:deskLop: "windows", 

Ssun-cecpH-iSsalist- “amd64” 

Fr 

systemEnvironment: í( 

LOCALAPPDATA: "C:UsersDinesh.RajputAppDataLocal", 

PROCESSOR LEVEL: "6*", 

FP NO HOST CHECK: YNOT, 

USERDOMAIN: "TIMESGROUP", 

LOGONSERVER: "XTGNOIFCTYDCOI", 

JAVA HOME: TC: Program Pilesdavajdkl.5-0 171", 

SESSIONNAME: "Console", 

APPDATA: "C:UsersDinesh.RajputAppDataRoaming", 

USERNAME: "Dinesh.Rajput", 

ProgramFiles(x86): "C:Program Files (x86)", 

VBOX MSI INSTALE PATH: "C:Progcam EtrlesOraclevirtualBox", 
CommonProgramFiles: "C:Program FilesCommon Files", 

Fa 

applicationConfig: [classpath:/application.properties]: { 
endpoints.health.enabled: "true", 

endpoints.health.id: "health", 

management.port: "98080", 
info-app.descripbron: “This is my first Working Spring Actuator Examples", 
info.app-version: "0.0.1-5NAPSHOT", 

endpoints.ınfo.id: "info", 

endpoints.metrics.id: "metrics", 


endpoints.metrics.sensitive: "false", 
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endpoints.metrics.enabled: "true", 
security.user.name: "admin", 
management.security.enabled: "true", 
security- User- pussword- "**5-***7. 
management.context-path: "/", 
info.app.name: "Spring Boot Actuator Application", 
endpoints.health.sensitive: "false", 
security.basic.enabled: "true", 
endpoints.info.enabled: "true", 
endpoinbEs.info.sensibive- "false" 

} 

} 


下 面 讨 论 端 点 如 何 显示 应 用 程序 的 各 项 指标 。 
3.3.4 显示 指标 病 点 


Spring Boot Actuator 可 否 看 处 于 运行 状态 下 的 应 用 程序 中 的 某 些 参数 ， 例 如 应 用 程 
序 内 存 状况 (有 效 或 释放 ) 。 下 列 代码 显示 了 /metrics 示例 端点 中 的 内 容 。 


1 

mem: 308504, 

mem.free: 219799, 
processors: d, 
instance-nupbime- 3912392, 
uptime: 3918108, 
systemload.averaqge: -1, 
heap.committed: 254976, 
heap-imnit-: 131072, 
heap.used: 3517/6, 

heap: 18478098, 
nonheap.committed: 54952, 
nonheagp-rnit: 2496, 
nonheap.used: 535/89, 
nonheap: 0, 

threads.peak: 225, 
threads.daemon: 23, 
threads.totalStarted-: 29, 
threads: Z5, 

Classes: 0793, 
classes.loaded: 6793, 


classes.unloaded: 0, 
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qc.ps scavenge.count: 38; 

gc.ps scavenge.time: 136, 

gc.ps marksweep.count: 2, 

gc.ps marksweep.time: 208, 
httpsessions.max: -1, 
httpsessions.active: 0, 
gauge.response.beans: 20, 
gauge.response.env: 16, 
gauge.response.autoconfig: 14, 
gauge.response.unmapped: 1, 
counter.status.200.boans: 2, 
counter.logtr:in.tarlure- 2, 
counter.logrin success: 10, 
eounter.stabus-200.sutoconrtidg- 2, 
counter.status.401.unmapped: 3, 
counter.status.200.env: 2 


} 


可 以 看 出 ， /metrics 问 点 提供 了 大 量 的 信息 。 
接 下 来 通过 /health 端点 得 看 应 用 程序 的 健康 状况 ， 如 下 所 示 : 
{ 
Status: "UP", 
diskSpace: 
{ 
status: "UP", 
total: 290391584768, 
free: 209372835840, 
threshold: 10485760 


} 


上 述 代码 展示 了 与 Spring 应 用 程序 健康 状况 相关 的 信息 。 除 了 基本 的 健康 状态 之 外 ， 
代码 中 还 包含 了 磁盘 空间 ， 以 及 应 用 程序 所 用 数据 库 的 状态 。 
接 下 来 讨论 如 何 通 过 /info 新 点 显示 应 用 程序 信息 。 


3.8.5 ”显示 应 用 程序 信息 


在 Spring Boot 中 ，Actuator 还 可 通过 /info 端点 显示 应 用 程序 信息 。 如 果 问 /info Jim x3 
生成 GET 请 求 调用 ， 上 默认 状态 下 将 会 返回 空 的 JSON 内 容 ， 即 个 。 
T JSON ŽRE, Spring Boot 并 未 对 应 用 程序 提供 默认 信息 。/info ij xi 8] 73 Spring 
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应 用 程序 提供 回 客 户 奖 或 公众 公开 的 任何 信息 。 相 应 地 ， 可 回 application.properties 或 
application.yml 的 该 六 点 中 添加 与 应 用 程序 相关 的 任何 信息 ， 如 下 所 示 : 


application.properties 


info.app.name-Spring Boot Actuator Application 
info.app.description-This is my first Working Spring Actuator Examples 
info.app.version-0.0.1-SNAPSHOT 
info.helpline.email-admin8dineshonjava.com 
info.helpline.phone-0120-000001100 
application.yml 
info: 
app: 
name: Spring Boot Actuator Application 
description: This is my first Working Spring Actuator Examples 
version: 0.0.1-SNAPSHOT 
helpline: 
email: admin(8dineshonjava.com 
phone: 0120-000001100 


在 上 述 示 例 中 ， 我 们 希望 所 供与 当前 应 用 程序 相关 的 未 些 信息 ， 例 如 /info Yr s 
中 的 应 用 程序 的 name、description、version、email 和 helpline。 了 随后， 可 请 求 /info Jm ri 
进而 得 到 下 列 啊 应 内 容 : 


{ 
helpline: 


{ 
email: "adminQ@dineshonjava.com", 
phone: "0120-00000110" 

- 

app: 

{ 


description: “This i5 my first Working Spring Actuator Examples", 
version: "U.0.1—-SNAPSHOT". 


name: "Spring Boot Actuator Application" 
} 


HIE, Spring Boot Actuator /info 病 上 点 回应 用 程序 外 部 展示 了 与 访 程 序 相 天 的 一 些 信 


aF 此 类 信息 ipu .可 供 调用 者 参考 。 
接 下 来 考查 如 何 利 用 Actuator 的 端点 来 关闭 应 用 程序 。 
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3.8.6 ”关闭 应 用 程序 


利用 /shutdown 端点 ， 可 关闭 当前 应 用 程序 。 但 在 默认 状态 下 ， 该 端点 将 处 于 禁用 状 
S. AE, 首先 需要 启用 /shutdown 端点 ， 随后 过 过 下 列 方式 加 以 使 用 : 


endpoints.shutdown.enabled=true 
下 列 代码 显示 了 利用 application.yml X: fFJ8 Hl VA iS &3 : 


endpoints: 
shutdown: 


enabled: true 


下 列 代码 将 调用 /shutdown 端点 : 


POST http://localhost:8080/shutdown 

上 述 代 码 可 视 作 一 个 POST 请 求 ， 并 返回 下 列 响应 内 容 : 

{ 

"message": "Shutting down, bye..." 

} 

/shutdown Jm xi n] RAMH FET. A m eE EAE FH VS Ea o 

Spring Boot Actuator 涉及 了 在 生产 环境 中 运行 应 用 程序 所 需 考虑 的 大 部 分 问题 。 但 
AZ — i XÆ Spring Boot 为 何 文 持 目 定 义 Actuator 靖 点 的 原因 。 

下 和 面 考 查 如 何 目 定义 Spring Boot Actuator 的 交点 。 


3.9.7 BÆNX. Actuator vm ra 


通过 Spring 属性 ， 还 可 自 定义 Actuator 端点 。 对 此 ， 端 点 可 通过 以 下 几 种 方式 进行 
目 定义 : 
Ja H/E Rog ea o 
敏感 性 。 
修改 端点 ID。 
编写 自 定 义 的 健康 状态 指示 器 。 
创建 目 定 义 冰点 。 
更 多 的 定制 行为 。 
当 在 应 用 程序 中 定制 属性 时 ， 可 局 用 或 鞭 用 茶 个 站 点 、 将 敏感 性 设置 为 true 或 false 


LLLLLL 
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并 目 定 义 其 ID. REZ, AAKARSH EXA Xm eas WA N arce 9m 3 ^E BI 
P. Pr erf Et Actuator. 


. 局 用 或 禁用 端点 
默认 状态 下 ， 在 Spring Boot 中 ， 除 了 /shutdown 之 外 ， 所 有 的 端点 均 处 于 启用 状态 ， 
但 也 可 禁用 某 些 疹 点 。 另 外 ， 也 可 在 必要 时 局 用 /shutdown i H « 


在 application.properties 文件 中 ， 对 应 操作 如 下 所 示 : 


endpoints.shutdown.enabled-true 


在 application.yml 文件 中 ， 对 应 操作 如 下 所 示 : 


endpoints: 
shutdown: 


enabled: true 


类 似 地 ， 还 可 通过 下 列 方式 蔡 用 其 他 病 局 


endpoints. endpoint id- -enabled — E3I5e 
f£ application.yml 文件 中 ， 对 应 操作 如 下 所 示 : 
endpoints: 


endpoint-id: 
enabled: false 


这 里 ,假设 希望 禁用 /health "ij i, TE application.properties 文件 中 ， 需 要 设置 下 列 属 性 : 


endpoints.health.enabled-true 


在 application.yml 文件 中 ， 对 应 操作 如 下 所 示 : 


endpoints: 
health: 
enabled: false 


HIN EA — UK TEHAVZS Hl A8 Bm 也 就 是 说 ， 在 application.properties 文件 中 将 下 
列 属性 设置 为 false. 


endpoints.enabled=false 
在 application.yml 文件 中 ， 对 应 操作 如 下 所 示 : 


endpoints: 
enabled: false 
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HfEUE $0, BA 3 5x32] 4b 3 2 HIA e SERI. MA. endpoints. endpoint- 
id.enabled = true， 可 再 次 局 用 某 些 特定 的 端点 。 

2. 修改 端点 ID 

在 表 3.1 中 ， 每 个 Actuator 端点 均 包含 一 个 ID， 并 可 作为 REST 服务 调用 该 端点 。 
例如 , health /metrics, /beans 冰点 分 别 作 为 ID 包含 了 健康 状态 信息 、 指 标 信 息 以 及 Bean。 
但 是 ， 我 们 也 可 修改 此 类 ID， 并 针对 应 用 程序 设置 所 希望 的 数值 ， 如 下 所 示 : 


endpoints.endpoint-id.id-new id 

例如 ， 当 修改 health ?m x1 ID 时 ， 需 要 将 其 修改 为 发 送 至 /status 的 GET 请 求 。 在 
application.properties 文件 中 ， 对 应 操作 如 下 所 示 : 

health.id = status 

在 application.yml 文件 中 ， 对 应 操作 如 下 所 示 : 

health: 

id: status 

随后 ， 可 通过 上 自 定 义 端点 /status 检测 当前 应 用 程序 的 健康 状态 信息 ， 其 工作 方式 与 
/health 端点 保持 一 致 。 

3. 修改 Actuator 端点 的 敏感 性 

默认 状态 下 ， 大 多 数 Actuator 端点 均 为 敏感 性 端点 ; Spring Boot Actuator 中 的 所 有 
BU i 53:15] EJ 29] ic Ei. 7 BUR PE Pty A o 因此 ， 对 于 安全 隐患 ， 闹 点 可 过 过 默认 的 属性 予以 
保护 。 相 关内 容 包 括 应 用 程序 属性 文件 中 的 用 户 名 、 密码 和 角色 。 EAT, A ym Ka A Bl 
含 敏感 性 信息 ， 可 将 其 敏感 性 设置 为 false， 如 下 所 示 : 


endpoints. endpoint id- sensilive - talse 
在 application.yml 文件 中 ， 对 应 操作 如 下 所 示 : 
endpoints: 


endpoint-id: 


sensitive: false 


A AR e cT AR Ee URB E. Msn] BEOCERCUC BL7J true. 
例如 ， 下 列 代 码 将 /health 端点 的 敏感 值 设 置 为 false: 


endpoints.health.sensitive-false 


在 application.yml 文件 中 ， 对 应 操作 如 下 上 所 未: 
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endpoints: 
health: 
sensitive: false 
当前 ， 无 须 任何 身份 安全 验证 即 可 访问 /health 端点 。 
Spring Boot Actuators 也 文 持 创 建 目 己 的 靖 点 ， 并 及 用 目 己 的 配置 和 实现 内 容 。 对 此 ， 
全 部 所 需 工 作 即 是 实现 疹 点 接口 并 重 载 其 中 的 方法 。 


4. 编写 自 定 义 健 康 状 态 指 示 咒 


Spring Boot Actuator 可 针对 应 用 程序 编写 自 定 义 健康 状态 指示 器 。Actuator 默认 的 
/health 端点 提供 了 与 应 用 程序 健康 状态 和 磁盘 空间 相关 的 信息 ， 如 下 所 示 : 
{ 
status: UE 
diskSpace: { 
status: "UP", 
total: 290391584768, 
free: 209125543936, 
threshold: 10485760 


} 

在 上 述 JSON gah, TIO UA T3 AE PE ERARAS AA S RA RK, /health 
"fh EA TH ZI ie BRUCH NERONE ete 
Bean; 同时 需要 提供 healthO 方 法 实现 ， 并 返回 一 个 Health 啊 应 结果 。 这 里 ，Health 啊 应 
应 包含 东 种 状态 ， 并 包含 条 些 可 显示 的 附加 细 市 信息 《可 选 )。 下 列 代 个 显示 了 J 了 
HealthIndicator 的 实现 过 程 。 


package com.dineshonjava.sba; 


import org.springframework.boot.actuate.health.Health; 

import org.springframework.boot.actuate.health.HealthIndicator; 
import org.springframework.stereotype.Component; 

import org.springframework.web.client.RestTemplate; 


aComponent 
public class DineshonjavaHealth implements HealthIndicator([ 


aOverride 
public Health health() | 
Ery f 
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RestTemplate rest = new RestTemplate (); 
rest.getForObject ("https://www.dineshonjava.com", 
String.class); 
return Health-up()-buiidt); 

| catch (Exception e) 1 
return Health.down().build(); 


} 


在 上 述 代 码 中 ， 我 们 设置 了 一 个 自 定义 健康 状态 指示 器 ， 进 而 检测 链接 应 用 程序 站 
A https://www.dineshonjava.com 的 健康 状 在 ， 并 返回 一 个 包 人 葬 站 氮 健 康 状 态 的 啊 应 结 


{ 

Stutus: 天国 和 

dineshonjavaHealth: { 
SEALS mE 

- 

diskSpace: { 
skale "UP 
total: 290391584768, 
Free: 2091290023204, 
threshold: 10483760 


} 


DineshonjavaHealth 类 重 载 了 HealthIndicator 接口 中 的 health077 1E. Jffü] E cH] T 
Spring 的 RestT'emplate 执行 对 https://www.dineshonjava.com 页 面 的 GET 请求 。 如 果 一 切 
正常， 则 返回 一 个 Health 对 象 ， 表 明 Dineshonjava 7j UP; 否则 将 抛 出 一 个 异常 并 返回 一 
个 Health 对 象 ,表明 Dineshonjava 为 DOWN。. 如 果 https://www.dineshonjava.com 7j DOWN, 
将 会 返回 下 列 啊 应 结果 : 


{ 

Status: "DOWN", 

dineshonjavaHealth: { 
Status: "DOWN" 

- 

diskSpace: { 
Stabs "HEB 
total: 290391584768, 
free: 209124999168, 
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threshold: 10485760 


不 难 发 现 ， 当 前 状态 为 DOWN， 但 也 可 添加 与 这 一 故障 相关 的 、 更 为 丰富 的 细节 信 
息 ， 并 通过 Health 构造 器 上 的 withDetail0 方 法 访问 该 站 点 ， 如 下 所 示 : 


return Health.down().withDetail("reason", e.getMessage()).build(); 


Let's see the response of the /health endpoint again. 
{ 
status: "DOWN", 
dineshonjavaHealth: { 
status: "DOWN", 
reason: "I/O error on GET request for 
"https://www.dineshonjava.com": www.dineshonjava.com; nested exception 
is jJava.net.UnknownHostException: www.dineshonjava.com" 
} ， 
diskSpace: { 
stal is: "UB". 
Cotal: 29039153041768, 
Free: 209124993012, 
threshold: 104857060 


} 


在 此 基础 上 ， 还 可 加 入 更 为 丰 军 的 细节 内 容 (无 论 是 成 功 还 是 故障 ) ， 即 调用 Health 
构造 器 类 的 withDetailO 方 法 。 
接 下 来 讨论 如 何 创建 一 个 自 定 义 端点 。 


3.3.8 ”创建 一 个 上 自 定义 端点 


Actuator 针对 应 用 程 iden 了 多 个 端点 ， 但 通过 实现 EndPoint 接口 ，Spring Boot 
Actuator 3 3 $6 EE EAE XX sis AA FIRA]: 


package com.dineshonjava.sba; 


import java.util.ArrayList; 


import java.util.List} 


import org.springframework.boot.actuate.endpoint.Endpoint; 


import org.springframework.stereotype.Component; 
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Component 


public class MyCustomEndpoint implements EndpointcList«String-»»[ 


aOverride 
public String getId() i 


return "myCustomEndpoint"; 


aQOverride 
public LrsbE-cSEring- invoke{) { 

// Custom logic to build the output 
List<String> list = new Arraylist--—(); 
list.add ("App message 1"); 
list.add("App message 2"); 
list-add ("App message 3"); 
list.add ("App message 4"); 
returnH list; 

} 
8Override 
public boolean isEnabled() í( 


return true; 


aOverride 
public boolean is5ensitive(t) I 


return true} 


} 


H. rH, MyCustomEndpoint 实现 了 EndPoint 接口 ,并 重 R 了 4 个 方法 :getId0、invokeO、 
isSensitiveO 和 isEnabled0 方 法 。 其 中 ，getId0 方 法 返回 端点 ID 或 名 称 。 据 此 ， 即 可 访问 
/myCustomEndpoint。 下 面 考 但 下 列 啊 应 所 返回 的 内 容 : 

[ 

"App message 1", 

"App message 2", 

"App message 3", 


"App message 4" 
] 


invoke0 方 法 返回 一 条 应 用 程序 消息 一 一 从 该 和 目 定义 端点 公开 的 任何 内 容 。isEnabled0) 
方法 用 于 局 用 应 用 程序 端点 ; isSensitiveO 方 法 则 用 于 设置 该 闫 点 的 敏感 性 。 
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Spring Boot Actuator 包含 了 多 种 日 定义 方式 。Spring Boot 文 持 日 定义 全 部 Actuator, 
这 也 体现 了 Spring Boot 目 有 的 特性 。 

一 些 Actuator 端点 会 显示 一 些 敏感 信息 ， 需 要 在 某 些 违规 操作 中 对 此 类 端点 予以 保 
护 。Spring Boot 可 实现 这 一 功能 ， 下 面 将 讨论 兹 点 的 安全 性 。 


34 Actuator 端点 的 安全 性 


Actuator [Jim £X 7J Ud Hl tre pk [ Spring 应 用 程序 相关 的 许多 信息 。 但 十 ， 如 末 将 
某 些 信 息 癌 调用 者 公开 ， 则 会 面临 某 些 安全 性 问题 。 例 如 ，/shutdown ij 53 H] TE 4E P^ 338 
中 关闭 应 用 程序 。 因 此 ， 如 果 将 其 公开 与 众 ， 访 病 点 对 于 应 用 程序 来 说 将 十 分 危险 。 关 
似 地 ，Spring Boot Actuator 中 的 许多 端点 同样 会 又 露 一 些 敏感 信息 ， 因 而 需要 对 其 提供 
安全 防范 ， 且 仅 供 经 验证 后 的 调用 者 使 用 。 对 此 ， 可 采用 Spring Security 以 确保 Actuator 
站 点 处 于 安全 状态 。 
虽然 Spring Boot 并 不 会 以 我 们 的 名 义 执行 任何 安全 措施 ， 但 它 确实 提供 了 一 个 
RequestMatchers， 并 以 此 结合 Spring Security 加 以 使 用 。 在 Spring Boot 应 用 程序 中 ， 这 
意味 着 作为 构建 依赖 关系 添加 Security Starter， 让 安全 自动 配置 负责 锁定 应 用 程序 ， 包 括 
Actuator jj Ki o 
针对 Spring Security, FJJ f Starter 依 顿 项 。 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-security«/artifactId» 
</dependency> 
这 将 使 所 有 的 Actuator 端点 处 于 安全 状态 。 除 此 之 外 ， 还 可 通过 以 下 方式 禁用 基本 
的 安全 项 。 在 application.properties 文件 中 : 


security.basic.enabled-false 


在 application.yml 文件 中 : 
basic: 
enabled: false 
上 述 配 置 仅 保留 了 更 加 安全 的 敏感 性 Actuator 端点 ， 同 时 使 其 余 端 点 处 于 开放 状态 
以 供 访问 。 
通过 定义 默认 的 安全 属性 , 可 对 敏感 性 端点 提供 安全 保障 , 例如 application.properties 
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文件 中 的 username, password. role, bn Pr: 

security.user.name-admin 

security.user.password-secret 

management.security.role-SUPERUSER 

上 述 配 置 使 Actuator 疹 点 处 于 安全 状态 。 如 果 对 此 类 疹 点 进行 调用 ， 将 会 询问 
username 和 password。 也 就 是 说 ， 未 经 授权 ， 将 无 法 访问 这 一 类 Actuator ig ei. 

Spring Boot 的 自动 配置 提供 了 Spring Security 配置 ， 除 此 之 外 ， 还 可 自 定义 Spring 
Security 配置 ， 以 锁定 某 些 危险 的 Actuator 端点 ， 如 /shutdown; 或 者 针对 特定 的 角色 提供 
此 类 Actuator iij i « 


下 面 考查 Spring Boot 2.0 中 的 一 些 变 化 内 容 。 
3.5 Spring Boot 2.x 中 的 Actuator 


Spring Boot Actuator 的 新 版 本 ， 即 2.x Actuator， 引 入 了 更 加 简化 的 模型 、 扩 展 的 功 
能 和 更 好 的 默认 设置 。 在 这 一 版 本 中 ， 出 于 简单 考虑 ， 安 全 模型 与 应 用 程序 之 间 实 现 了 
集成 ， 并 加 入 了 更 多 的 HTTP 请 求 和 响应 、Java API。 此 外 ， 最 新 版 本 还 支持 CRUD 的 
读 写 模型 。 

Actuator 2.x 定义 了 可 扩展 的 模型 BAIER EHAKE MVC。 因 此 ， 我 们 可 
使 用 MVC 和 Web Flux. EJER, WRS T. Gr eEXb T ASH. Mb. dS 
JA HER. DURIRHEUU FRIA: 


management.endpoints.web.expose = *. 


md. WIR GBJHHPUEREm es. np fupe 70 H8 EUH ER eas HS y ea DU DS 
持 不 变 。 默 认 状 态 下 ， 所 有 的 Actuator 端点 将 设置 在 /actuator 路 径 中 。 
Spring Boot 2.x Actuator 还 引入 了 一 些 内 建 病 点 ， 有 基体 如 下 。 
/conditions: 重 命 名 后 的 auto-config。 
/Prometheus: 等 同 于 metrics, [H xc fF Prometheus 服务 器 。 
Scheduledtasks: 该 冰 点 提供 了 应 用 程序 中 每 项 调度 任务 的 细 贡 内 容 。 
/sessions: 使 用 Spring Sessions 的 HTTP 会 话 列 表 。 
/threaddump: | ii UE fia d EE dH ds. e 
Spring Boot 2.x Actuator 也 采用 了 与 之 前 类 似 的 方式 操控 端点 ， 用 户 可 对 其 进行 自 害 
义 ， 但 目 定 义 方法 中 引入 了 一 些 变 化 一 一 2.x Actuator 支持 CRUD 操作 ， 而 不 再 仅 是 读 、 
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Spring Boot Actuator 可 方便 地 操控 和 管理 应 用 程序 。 


36 AK xL 


本 章 介绍 了 Spring Boot CLI 及 其 安装 步骤 。Spring Boot CLI 提供 了 简单 、 快 速 的 
Spring Boot 应 用 程序 开 有 友 方 式 ， 利 用 CLI， 可 运行 基于 Groovy 语言 的 Spring Boot 应 用 
程序 ， 并 以 较 少 的 代码 故障 开 肥 Spring 应 用 和 程序。 另外，Spring Boot CLI 还 可 目 动 处 理 
多 种 依赖 库 , 并 利用 Gradle @Grab 注解 显 式 地 声明 依赖 天 系 , HENA Maven 或 Gradle 
定义 构建 规范 。 

通过 基于 Web 的 Spring Boot CLI, 本 章 还 运行 了 一 个 简单 的 Hello World REST 应 用 
EU. 

本 章 还 讨论 了 处 于 生产 环境 下 的 Spring 应 用 程序 。 针 对 于 此 ，Spring Boot 提供 了 一 
个 该 环境 下 的 特性 ， 即 Spring Boot Actuators Actuator 包含 了 多 个 端点 ， 我 们 可 通过 基于 
Web 的 REST 服务 .远程 Shell 和 JMX 客户 端 监视 这 些 端 点 .此 外 , 还 可 对 这 一 类 Actuator 
冰点 执行 目 定 义 操作 。 

第 4 章 将 讨论 Spring Cloud 和 相关 配置 操作 。 
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第 3 * WE Spring Boot CLI 的 安 痛 过程， 以 及 基于 CLI 的 应 用 程序 的 构建 和 执行 
过 程 。Spring Boot CLI 则 在 提供 无 代码 故障 的 、 快 速 的 应 用 程序 实现 。 此 外 ， 我 们 还 学 
2] f Spring Boot 生产 环境 特性 ， 即 Actuators Actuator 涵 靖 了 所 有 生产 操作 环节 中 的 各 
项 指标 ， 以 及 应 用 程序 在 生产 阶段 中 的 健康 状态 。 

本 章 将 介绍 Spring Boot 中 的 男 一 个 扩展 组 件 一 一 Spring Cloud, 包括 其 用 途 、 构 建 原 
生 云 应 用 程序 时 Spring Cloud 的 解决 方案 ， 以 及 分 布 式 环境 下 所 处 理 的 常见 问题 。 

在 阅读 完 本 章 后 ， 读 者 将 理解 如 何 配 置 Spring Cloud 服务 器 ， 以 及 基于 分 布 式 应 用 
程序 的 客户 闹 。 

本 章 主要 涉及 以 下 主题 : 

0 原生 云 应 用 程序 架构 。 

Q URS AM. 
> 面临 的 挑战 。 

Spring Cloud 简介 。 

Spring Cloud 应 用 。 

基于 Spring Cloud 的 项 目 。 

开启 Spring Cloud 之 旅 。 

> Spring Cloud 配置 管理 。 

> SEIL Spring Cloud 配置 服务 器 。 
> ”实现 Spring Cloud 配置 客户 端 。 
接 下 来 将 对 此 加 以 逐一 讨论 。 
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EWH « 安德森 所 说 ， 软 件 正 在 耕 嗓 世界 。 因 此 ， 软 件 也 是 每 项 业务 的 主要 文 柱 
之 一 。 顶 尖 企 业 的 创新 主要 体现 在 以 下 共同 特点 : 
D ”软件 的 速度 。 
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Q ”服务 的 可 用 人 性。 

”软件 的 可 伸缩 性 。 

2 ”针对 所 有 设备 的 软件 的 用 户 体 验 ， 例 如 计算 机 设备 和 移动 设备 。 

云 计 算是 软件 创新 的 主要 发 展 方 回 之 一 ; 为 软件 提供 原生 云 解决 方案 和 架构 是 许多 
顶级 公司 所 采取 的 创新 之 一 。 云 计算 采用 弹性 方式 提供 按 需 存储 的 资源 和 网 络 解决 方案 ， 
这 一 类 服务 包括 Amazon Web 服务 、 谷 歌 云 和 Microsoft Azure. 

采用 原生 云 应 用 程序 架构 包含 诸多 优势 ， 并 可 解决 常见 的 可 伸缩 性 、 持 久 性 和 可 用 
性 问题 。 以 下 是 原生 云 应 用 程序 架构 的 一 些 常 见 应 用 场合 : 

2 ”应 用 程序 的 速度 。 
安全 性 和 可 靠 性 。 

PEE B n] ARR TE o 
应 用 程序 的 监测 机 制 |。 

Q ”故障 隅 离 和 容错 机 制 。 

鉴于 分 布 式 特征 和 可 伸缩 性 ， 应 用 程序 应 齐 循 原生 云 模式 ， 且 应 设置 为 横 回 伸缩 模 
式 ， 而 非 纵 癌 伸缩 。 其 中 ， 微 服务 架构 便 是 横 癌 伸缩 应 用 程序 架构 示例 之 一 。 用 户 可 在 
有 限 的 上 下 文 环境 中 创建 许多 小 型 应 用 程序 或 服务 ， 而 不 是 创建 单一 的 大 型 应 用 程序 。 
原生 云 模式 提供 了 最 佳 的 资源 利用 方案 ; 如 果 应 用 程序 需要 使 用 到 相关 资源 ， 它 会 根据 
需要 弹性 地 提供 资源 ， 否 则 需要 释放 这 些 零 利用 率 的 资源 。 


O +s. 
横向 伸缩 意味 着 ， 可 根据 具体 需求 向 现 有 的 应 用 程序 中 添加 资源 ， 且 无 须 对 该 应 用 
程序 做 任何 修改 。 在 纵向 伸缩 中 ， 则 需要 改变 应 用 程序 的 架构 。 


如 果 和 希望 创建 应 用 程序 ， 那 么 ， 在 初始 设计 阶段 ， 则 需要 关注 原生 云 应 用 程序 架构 
的 关键 特性 。 下 列 内 容 列 出 了 原生 云 应 用 程序 的 关键 特征 。 

Q 十 二 要 素 应 用 程序 ， 针对 优化 后 的 应 用 程序 的 一 组 
速度 、 安 全 和 可 伸缩 性 方面 的 设计 方案 。 

口 ” 微 服务 : 根据 微服 务 模 式 ， 可 创建 独立 、 无 关 的 服务 ， 例 如 在 不 影响 其 他 业务 
服务 的 前 提 下 对 其 进行 部 署 。 

Q ”自助 服务 敏捷 的 基础 设施 : 这 与 云 平 台 和 基础 设施 相关 ， 使 得 开发 团队 可 在 某 
个 应 用 程序 和 服务 抽象 层 上 进行 操作 。 

D ”基于 API 的 协作 : 定义 了 多 个 微服 务 间 服务 -服务 间 的 交互 行为 。 

O PME: 这 与 啊 应 性 有 关 ， 意 味 着 当 增 加 系统 负载 时 《例如 激增 的 流量 、 速 
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模 数 ， 旨 在 改善 应 用 程序 的 
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度 和 规模 ) ， 系 统 能 够 提升 其 响应 能 力 ， 进 而 增加 系统 的 安全 性 。 
上 述 内 容 可 视 为 基于 云 的 应 用 程序 的 最 佳 实践 。Spring Cloud 则 在 此 基础 上 进一步 发 
扬 了 这 种 风格 。 下 面 将 讨论 原生 云 应 用 程序 的 特征 之 一 ， 即 微服 务 架构 。 


4.1.1 f Bg 25 2E T4 


微服 务 并 不 是 一 个 新 鲜 的 事物 ， 这 一 名 词 是 在 2005 年 由 Peter Rodgers 博士 提出 的 ， 
最 初 被 称 为 基于 SOAP 的 微 Web 服务 。 术 语 微 服务 表示 将 大 型 软件 转化 为 多 个 组 成 部 分 ， 
每 个 组 成 部 分 强调 特定 的 业务 点 。 与 应 用 范围 较为 广泛 的 现 有 单 体 应 用 程序 相 比 ， 微 服 
务 类 似 于 包含 特定 目标 的 、 较 小 范围 内 的 小 型 服务 。 

因此 ， 微 服务 将 单 体 应 用 程序 划分 为 较 小 的 微服 务 ， 并 作为 单一 业务 目标 管理 、 部 
著 此 类 微服 务 。 对 于 开 友 人 员 来 说 ， 此 类 分 布 式 服务 间 的 通信 是 一 项 较为 困难 的 任务 。 
使 用 Spring Cloud 可 人 简化 这 些 分 布 式 服务 间 的 集成 操作 。 

当今 ， 各 个 行业 每 天 或 每 周 都 在 致力 于 新 的 功能 实现 和 创新 行为 ， 不 断 地 将 应 用 程 
序 扩展 到 更 大 的 规模 。 各 种 系统 之 间 的 复杂 性 和 耦合 性 使 得 更 改 应 用 程序 中 的 任何 内 容 
都 变 得 非常 困难 。 因 此 ， 无 论 变化 的 大 小 ， 负 责 不 同 模块 的 团队 必须 考虑 对 应 用 程序 各 
个 部 分 间 的 影响 。 

图 4.1 显示 了 在 未 采用 微服 务 架 构 时 单 体 应 用 程序 的 示意 图 。 


Banking Application 
AccountService, CustomerService, NotificationService, .... 


图 4.1 


不 难 发 现 ， 图 4.1 中 显示 了 基于 单 体 架构 的 Banking Application 〈 未 采用 微服 务 ) ， 
这 是 一 种 一 体 化 的 应 用 程序 。 也 就 是 说 ， 所 有 模块 均 位 于 单一 应 用 程序 中 ， 如 
AccountService、CustomerService 和 NotificationService。 

假设 打算 调整 CustomerService， 对 此 ， 应 确保 其 他 模块 的 推送 和 账户 服务 不 会 受到 
其 架构 设计 的 影 啊 。 


-72° 精通 Spring Boot 2.0 


下 面 将 单 体 应 用 程序 根据 当前 模型 划分 为 独立 的 组 成 部 分 ， 同 时 利用 微服 务 架 构 了 巴 
以 构建 ， 如 图 42 所 示 。 


CustomerService | | NotificationServices 


ification DB 


"Account DB.» -— -— 


MySQL Oracle MongoDB 


图 4.2 


不 难 上 友 现 ， 这 里 采用 了 基于 微服 务 的 架构 构建 Banking Application。 其 中 ， 主 应 用 程 
序 被 分 解 为 一 组 子 应 用 程序 集 ， 即 微服 务 。 

当 Spring 核心 概念 应 用 于 应 用 程序 架构 中 时 ，Spring 文 持 应 用 程序 组 件 间 事 务 的 分 
离 ， 例 如 松散 耦合 〈 更 改 后 的 效果 处 于 隔离 状态 ) 和 紧密 内 聚 ( 代 码 执行 单个 定义 民 好 
的 任务 ) 。 类 似 地 ， 微 服务 具有 相同 的 优点 ， 即 应 用 程序 协作 服务 之 间 的 松散 耦合 ， 并 
可 以 独立 地 更 改 这 些 服务 。 人 微服 务 的 男 一 个 优点 则 是 紧密 的 内 有 聚 性 ， 这 意味 着 应 用 程序 
服务 可 处 理 单 个 的 数据 视图 ， 这 也 称 作 有 界 上 下 文 或 域 驱 动 设计 (DDD) 。 

下 面 考查 微服 务 架 构 的 优点 。 


4.1.2 ”微服 务 的 优点 


当 在 应 用 程序 中 采用 微服 务 淋 构 时 ， 其 优点 主要 表现 在 以 下 几 个 方面 : 
代码 库 较 小 且 易 于 维护 。 

独立 组 件 的 可 伸缩 性 。 

技术 多 样 化 。 用 户 可 使 用 多 种 混合 库 、 框 和 架 、 数 据 存储 和 语言 。 
故障 隅 离 。 组 件 故 障 不 会 影响 到 整个 系统 。 

可 较 好 地 支持 小 型 、 并 行 开 友 团队 。 

JULII BEA. 

精简 团队 的 同时 降低 开销 。 
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微服 务 架 构 包 含 了 诸多 优点 ， 且 大 多 数 集中 在 可 靠 性 和 敏捷 性 方面 。 此 外 ， 微 服务 
架构 也 面临 看 一 些 调整 ， 下 面 将 对 此 加 以 讨论 。 


4.1.3 ”做 服务 面临 的 挑战 


虽然 微服 务 架 构 包 含 了 许多 优点 ， 但 同时 也 面临 着 某 些 挑战 任务 ， 其 中 包括 以 下 
服务 间 难 以 实现 完整 的 一 致 性 ， 例 如 多 个 处 理 过 程 中 的 ACID 交易 的 维护 。 
分 布 式 系 统 通常 难以 调试 和 跟踪 。 
涉及 较 多 的 端 到 端 测试 。 
应 用 程序 的 开 友 和 部 普 方 式 。 
服务 间 的 通信 和 服务 间 的 调用 。 

此 外 ， 还 存在 与 微服 务 基础 设施 相关 的 一 些 挑战 性 任务 ， 其 中 ， 多 个 处 理 过 程 作为 
单一 业务 单元 整体 工作 。 考虑 到 分 布 式 系统 的 特征 ,问题 主要 集中 于 如 表 4.1 所 示 的 几 个 
方面 。 
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多 个 微服 务 间 如 何 彼此 发 现 服务 发 现 
如 何 确 定 所 用 的 服务 实例 客户 端 加 载 平 衡 
特定 的 微服 务 未 予 响应 故障 隔离 
如 何 控制 微服 务 的 访问 ， 例 如 提供 安全 措施 和 速率 限制 服务 安全 
多 个 微服 务 彼 此 间 如 何 通信 消 妃 传输 机 制 


可 以 看 到 , 微服 务 和 分 布 式 系统 面临 着 诸多 挑战 , 但 Spring Boot 可 简化 微服 务 应 用 。 
除 此 之 外 ，Spring Cloud 也 对 此 提供 了 相应 的 解决 方案 。 通 过 目 动 配置 操作 ，Spring Cloud 
使 得 分 布 式微 服务 的 开发 过 程 更 具 实 践 性 。 

Spring Boot 可 伽 化 做 服务 的 开发 过 程 ， 其 中 包括 以 下 方面 : 

Q ”利用 Spring Boot 可 创建 多 个 微服 务 。 

Q 383 RestController 显示 资源 。 

Q ”通过 RestTemplate 使 用 远程 服务 。 

Spring Cloud 的 主要 功能 体现 在 : 持续 部 普 、 深 动 升级 新 版 本 代码、 在 产生 故障 时 的 
快速 回 深 ， 以 及 同时 运行 同一 服务 的 多 个 版 本 。 下 面 将 对 Spring Cloud 展开 详细 讨论 。 
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Spring 开发 团队 在 Spring 框架 上 提供 了 Spring Boot， 通 过 模块 上 的 目 动 配置 操作 傈 
化 了 Spring 应 用 程序 的 开 友 。 Spring Boot 表示 为 Spring Core Framework 的 扩展 ; 相应 地 ， 
Spring Cloud 也 是 Spring Boot 的 扩展 ， 并 提供 了 多 个 库 且 强调 多 种 原生 云 模式 。 ips 
Cloud Xf Spring Boot 的 扩展 主要 体现 在 ， 通 过 多 个 库 改 善 应 用 程序 的 工作 机 制 (添加 至 
REIER) 。 在 开始 阶段 ， 可 以 笑 试 使 用 基本 的 默认 行为 ， 随 后， 我 们 可 设计 或 扩展 上 日 
XE X Vid. 

Spring Cloud 是 Spring 研 友 团队 有 友 布 的 大 型 项 目 ， 其 下 还 包 舍 了 请 多 于 项 目 。 作 为 
Spring 于 项 目的 集合 ， 它 提供 了 针对 原生 云 模式 的 解决 方案。 其 中 ， 问 题 主 要 来 目 应 用 
程序 规模 、 流量 的 增长 ， 或 者 是 平台 及 生 了 变化 〈 例 如 移 至 移动 平台 ) 。 如 前 所 述 ， 微 
服务 是 针对 原生 云 问 题 的 解决 方案 之 一 。 

Spring Cloud 为 编码 人 员 提 供 了 较 大 的 余地 , 进而 可 快速 整合 分 布 式 系统 中 的 部 分 帝 
MEA AUMERE, WRZ A MAREM AR) 。 通 过 Spring Cloud. wig 
人 员 可 简单 、 快 速 地 设置 基于 分 布 式 系统 的 应 用 程序 和 配置 内 容 ， 其 中 包括 特定 的 工作 
站 、 主 服务 器 以 及 其 他 平台 ， 如 Cloud Foundry. 


4.2.1 云 和 微服 务 程 序 的 构造 块 


基于 应 用 程序 的 架构 ，Spring Cloud 可 视 为 云 和 微服 务 的 构造 块 ， 并 针对 Spring 原生 
云 提供 了 平台 文 持 。 下 面 列 出 了 原生 云 服 务 所 需 的 构造 块 。 

QU 平台 支持 和 IaaS: 访问 特定 的 平台 信息 和 Cloud Foundry, AWS, Heroku 中 的 服务 。 

”微服 务 基础 设施 :提供 了 有 效 的 服务 ， 例 如 服务 发 现 、 配 置 服务 器 和 监测 机 制 。 
其 中 存在 多 个 开源 项 目 可 供 使 用 ， 如 Netfilx OSS 和 HashiCorp Consul. 

D ”动态 云 重 配置 : 可 针对 服务 创建 分 布 式 配置 。 针 对 多 种 应 用 程序 和 环境 的 分 布 
式 配置 的 构建 和 服务 ，Spring Cloud Config 提供 了 客户 端 和 服务 器 解决 方案 。 

LU z ILLA: Spring Cloud 提供 了 多 种 云 工 具 ， 如 Spring Cloud Security. Spring 
Cloud CLI, Spring Cloud Stream。 其 中 ，Spring Cloud Security 针对 安全 服务 和 
控制 访问 提供 了 安全 措施 ; Spring Cloud Stream 则 用 于 消息 传输 机 制 和 基于 事件 
的 云 应 用 程序 ，Spring Cloud CLI 主要 人 负 贡 在 Groovy 中 快速 地 创建 应 用 程 订 。 

OD ”数据 获取 : 该 Spring Cloud 构造 块 用 于 微服 务 信息 管道 中 的 数据 汽 ， 如 Spring 
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Cloud Data Flow 和 Spring Cloud Modules. 

Q Spring Boot Style Starter: Spring Cloud 是 Spring Boot 的 扩展 ， 因 此 ， 原 生 云 应 
用 程序 需要 使 用 到 Spring Boot 以 实现 正常 工作 。 

4.3 显示 了 云 和 微服 务 源 程序 的 全 部 构造 块 。 


Spring Cloud 


ow g Ci oud ko mo - poai ie 
上 AN 


prng FL hdi Cloud L3 Bici Cloud pre 
cae FL hdi Bici 
Spring Cloud Spring Cloud Spring Cloud 
For AWS Cluster Stream 


— Dynamic Service Cloud Utilities Data Ingestion 
Integration Reconfiguration Infrastructure 


图 4.3 


在 图 4.3 中 可 以 看 到 ，Spring Cloud 关联 了 多 个 子 项 目 。Spring Cloud 针对 每 种 原生 

云 问题 提供 了 相应 的 解决 方案 。 下 面 查看 与 Spring Cloud 关联 的 主要 项 目 。 

Spring Cloud Config: 由 Git 存储 库 集 中 文 持 的 外 部 配置 管理 。 其 中 ， 配 置 资源 

表述 了 Spring 环境 ; 必要 时 ， 也 可 用 于 非 Spring 应 用 程序 。 

Q Spring Cloud Bus: 用 于 将 服务 实例 和 服务 与 分 布 式 消 息 一 起 连接 的 事件 总 线 。 
这 有 助 于 在 分 组 中 传递 状态 变化 (例如 配置 更 改 事件 〉。 

Q Spring Cloud Netflix: 整合 和 混合 不 同 的 Netflix OSS Et (segment ， 如 Eureka. 
Hystrix, Zuul, Archaius 等 。 

L) Spring Cloud Cluster: 包含 了 有 状态 模式 ， 抽 象 的 领导 选举 Ceadership election) 
能 力 ， 以 及 针对 Zookeeper、Redis、Hazelcast、Consul 的 应 用 。 

Qç Spring Cloud Consul: 基于 Hashicorp Consul 的 服务 公开 和 设计 管理 。 

口 Cloud Foundry: 将 应 用 程序 与 Cloud Foundry 进行 整合 。 生 成 服务 实现 ， 进 而 简 
化 执行 SSO 和 OAuth2 数据 资源 ， 同 时 还 将 生成 Cloud Foundry 代理 服务 。 

D Spring Cloud Foundry Service Broker: 构建 代理 服务 的 开始 阶段 , 用 于 人 处理 Cloud 
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Foundry 管理 服务 。 

Spring Cloud Connectors: 使 处 于 不 同 阶段 的 Paas 应 用 程序 能 够 轻松 地 与 后 着 运 
行 的 服务 〈 如 数据 库 和 消息 代理 ， 以 前 称 为 Spring Cloud 的 项 目 ) 相关 联 。 
亚马逊 Web 服务 的 Spring Cloud: 简单 地 与 Amazon Web 服务 提供 的 主机 混合 
使 用 。 它 提供 了 一 种 有 用 的 方法 ， 可 以 利用 Spring 习惯 用 法 和 API Cni ae 
X& API) 与 AWS 的 给 定 服 务 协 作 。 程 序 员 可 以 在 不 考虑 基础 或 支持 的 情况 下 ， 
围绕 便利 的 服务 构建 应 用 程序 。 

Spring Cloud Security: 为 调整 后 的 堆栈 OAuth2 REST 客户 、Zuul 代理 中 的 号 份 
验证 或 确认 头 传输 提供 玫 助 。 

Spring Cloud Sleuth: Spring Cloud 应 用 程序 的 分 布 式 跟 踩 机制， 且 完 美 地 与 
Zipkin、HTrace 和 日 志 (W ELK) 相 结合 。 

Spring Cloud Data Flow: 为 当前 运行 期 上 的 微服 务 应 用 程序 提供 原生 云 安排 服 
务 。 简 单 易 用 的 DSL、 直 观 的 GUI 和 REST-API 一 起 解决 了 基于 微服 务 信 息 管 
X8 HJ — i EZH ZR In] jet o 

Spring Cloud Stream: 小 型 的 、 基 于 事件 的 微服 务 结构 ， 可 快速 整合 与 外 部 框架 
关联 的 应 用 程序 。 这 也 是 一 类 较为 基本 的 启发 式 模型 ， 使 用 Apache Kafka 或 
RabbitMQ 在 Spring Boot 应 用 程序 之 间 发 送 和 获取 消息 

Spring Cloud 中 的 Stream App Starter: 表示 Spring Boot 启动 器 ， 在 与 外 部 框架 
结合 使 用 时 将 得 到 进一步 的 增强 。 

Spring Cloud Task: 一 个 相对 短暂 的 微服 务 框架 ， 用 于 快速 构建 执行 有 限 信 息 处 
理 措 施 的 应 用 程序 。 

Spring Cloud Zookeeper: Apache Zookeeper 服务 有 友 现 和 配置 。 

Spring Cloud Starter: Spring Boot 风格 的 Starter 操作 ， 以 简化 Spring Cloud 客户 
的 依赖 管理 (在 Angel. SR2 之 后 停止 ) 。 

Spring Cloud CLI: Spring Boot 捅 件 ， 并 在 Groovy 中 快速 生成 Spring Cloud 应 用 
程序 。 

Spring Cloud Contract: 处 理 开 友人 员 所 需 的 客户 驱动 的 契约 方法 。 

Spring Cloud Gateway: 十 一 种 针对 Project Reactor 的 元 敏 可 编程 开关 。 


Spring Cloud 应 用 


取决 于 具体 应 用 ，Spring Cloud 包含 了 多 个 模块 ， 同 时 也 存在 Spring Cloud 所 文 持 的 
多 个 用 例 ， 例 如 云集 成 、 动 态 重 配置 、 服 务 友 现 、 安 全 和 数据 获取 。 稍 后 还 将 深入 讨论 
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微服 务 文 持 方面 的 内 容 ， 例 如 服务 发 现 以 及 客户 端 负载 平衡 。 
下 列 内 容 显示 了 典型 的 Spring Cloud 用 例 以 及 扩展 系统 : 
分 布 式 配置 。 
服务 注册 。 
服务 发 现 。 
EI BEER HH 
分 布 式 消息 传输 机 制 e 
负载 平衡 。 
Ir ER ds o 
领导 选取 和 集群 状态 。 
全 局 锁 。 
Q ”服务 -服务 调用 。 
接 下 来 将 讨论 与 Spring Cloud 相关 的 配置 问题 ， 并 得 看 如 何 利 用 Spring Cloud Config 
配置 一 个 分 布 式 系统 。 


L LULL LCCOL 
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原生 云 应 用 程序 的 主要 问题 之 一 是 分 布 式 服务 间 的 维护 和 分 布 配置 。 开 有 人员 一 般 
会 伦 费 大 量 的 时 间 配 置 每 个 与 特定 环境 相关 的 配置 项 ， 在 横 回 服务 伸缩 时 期 ， 需 要 再 次 
重新 配置 相关 服务 。Spring Cloud 针对 原生 云 问 题 提供 了 一 个 模块 或 子 项 目 ， 称 作 Spring 
Cloud Config. 

Spring Cloud Config 是 Spring Cloud 生态 系统 中 的 一 个 子 项 目 ， 并 提供 了 服务 器 和 客 
户 站 解决 方案 ， 进 而 在 多 种 环境 和 分 布 式 系统 中 存储 和 服务 分 布 式 配置 。 

外 部 配置 管理 由 Git 集中 文 持 。 配 置 数 据 资 源 描述 了 对 应 的 Spring 环境 ;， 必 要 时 ， 
也 可 供 非 Spring 应 用 程序 加 以 使 用 。 我 们 可 以 创建 外 部 配置 ， 也 可 以 在 中 央 位 置 使 用 现 
有 配置， 例如 Git 版 本 控制 。Spring Cloud Config 针对 配置 的 创建 和 应 用 所 供 了 文 持 ， 有 其 
体 如 下 : 

Qd Spring Cloud Config Server. 

Q Spring Cloud Config Client. 

该 配置 与 Spring 应 用 程序 实现 了 民 好 的 匹配 ， 针 对 任意 环境 和 编程 语言 ， 可 通过 
Environment, PropertySource 或 @Value 对 其 加 以 使 用 。 在 持续 部 署 (CD ) 管道 中 ，Spring 
应 用 程序 从 部 羞 阶段 移 至 测试 阶段 ， 并 对 生产 环境 进行 测试 。 我 们 可 以 在 所 有 环境 中 方 
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便 地 对 配置 内 容 进 行 管理 ， 同 时 还 可 确保 Spring 应 用 程序 在 每 处 包含 名 项 资源 ， 这 在 迁 
移 时 必 不 可 少 。 

RAAS F> Spring Cloud Config Server 使 用 Git 实现 ， 同 时 还 可 方便 地 文 持 配置 环 
境 的 标记 版 本 。 此 外 ， 我 们 还 可 方便 地 添加 可 普 代 的 实现 方案 ， 并 利用 Spring ME T A 
插入 。 

FARNERS IRR, 将 所有 的 配置 内 容 系 积 值 早 一 的 Git 存储 库 中 ,并 将 其 连接 
至 管理 东 项 配置 的 东 个 应 用 程序 上 《针对 全 部 应 用 程序 ) 。 除 此 之 外 ， 还 将 尝试 设置 一 
个 简单 的 实现 方案 。 


4.4 ”创建 配置 生成 器 一 一 Spring Cloud Config Server 


本 节 讨 论 如 何 创 建 一 个 基于 Git 的 Spring Cloud Config Server， 并 将 其 用 于 简单 的 
REST 应 用 程序 服务 器 中 。 

对 此 ， 可 访问 http://start.spring.io， 选 取 Maven and Spring Boot 2.0.2.RELEASE， 并 
将 Artifact 设置 为 cloud-config-app。 此 外 ， 还 可 针对 Config Server 选取 依赖 关系 并 添加 
该 模块 。 随 后 ， 生 成 该 应 用 程序 ， 并 可 利用 事先 配置 的 项 目下 载 ZIP 文件 。 

下 列 依赖 关系 将 在 全 部 项 目 之 则 共 诗 : 


<parent> 
«groupld»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-parent«/artifactId» 
«version»2.0.2.RELEASE«c«/version» 
«relativePath/» «!-- lookup parent from repository 一 一 学 
«/parent» 


«properties» 
«project.build.sourceEncoding»UTF-8«/project.build.sourceEncoding» 
«project.reporting.outputEncoding»UTF-8«/project.reporting.output Encoding» 

«java.version»1.8«/java.version» 
«spring-cloud.version»Finchley.BUILD-SNAPSHOT«/spring-cloud.version» 
«/properties» 


«dependencies» 

«dependency» 
«groupId»org.springframework.cloudc/groupId» 
«artifactId»spring-cloud-config-server«/artifactId» 

</dependency> 
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«/dependencies» 


«dependencyManagement-^ 
«dependencies» 

«dependency» 
«groupld»org.springframework.cloud«c/groupld» 
«artifactId»spring-cloud-dependenciesc/artifactId» 
«version»$íspring-cloud.version]«/version» 
«type»pom«/type» 

«scope»import«c«/scope» 
</dependency> 
</dependencies> 


</dependencyManagement> 


在 上 述 Maven POM 配置 文件 中 ， 我 们 使 用 了 Spring Cloud JUI) Finchley. 


BUILD-SNAPSHOT 版 本 。 访 版 本 序列 针对 所 有 关联 的 模块 管理 依赖 天 系 ， 这 可 在 
<dependencyManagement> 标 签 中 看 到 。 此 处 针对 cloud-config-app 应 用 程序 添加 了 spring- 
cloud-config-server 模块 ,在 设置 了 依赖 天 系 管理 之 后 ,下面 尝 试 实现 Cloud Config Server. 


45 实现 Cloud Config Server 


本 方 将 实现 应 用 程序 的 主 类 ， 其 中 涵 新 了 多 个 特定 的 注解 。 此 人 处,，@SpringBootApplication 


将 包含 所 有 的 默认 和 所 需 的 配置 ， 为 一 个 注解 @EnableConfigServer 将 把 应 用 程序 转换 为 
一 个 配置 服务 器 ， 如 下 所 示 : 


package com.dineshonjava.cloudconfigapp; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 


import org.springframework.cloud.config.server.EnableConfigServer; 


aSpringBootApplication 

aEnableConfigServer 

public class ClondConfigApplrcabion | 
publiqc static void main(String] situs) 1 


SpringApplication.run(CloudConftgApplrcation.class, args); 


} 
XCÉETE 2g — AERA 384 H1 a MHE. BESRA T DI AS RI 7 


* 80* 精通 Spring Boot 2.0 


8080。 当 然 ， 我 们 可 修改 这 一 默认 的 端口 配置 ， 但 需要 提供 Git URI， 这 提供 了 相应 的 版 
本 控制 配置 内 容 。 下 面 合 看 application.properties 文件 。 


4.5.1 配置 application.properties 文件 


此 处 将 使 用 application.properties 文件 ， 如 下 所 示 : 

server .port=8888 

spring.application.name-cloud-config 

spring.cloud.config.server.git.uri-file://S[user.home]/app-config-repo 

可 以 看 出 , 此 处 配置 了 3 个 属性 , 即 server.port. spring.application.name 和 spring.cloud. 
config.server.git.uri。 HLF, ${user.home}/app-config-repo 表示 为 一 个 包 合 YAML 和 属性 
文件 的 Git 存储 库 。 


O 注意 : 
对 于 Windows 环境 ， 需要 使 用 额外 的 /， 即 file:///; 而 在 Unix 环境 下 ， 则 需要 使 用 
file://, 


接 下 来 探讨 如 何在 本 地 及 其 上 构建 本 地 Git 存储 库 。 
45.2 创建 Git 存储 库 作 为 配置 存储 


下 列 代码 示例 创建 了 一 个 Git 存储 库 : 

cd SHOME 

mkdir app-config-repo 

cd app-config-repo 

git init . 

echo 'user.rolezDev' > application-dev.properties 

echo 'user.role-Admin!' > application-prod.properties 

git add . 

git commit -m 'Initial commit for application properties' 


通过 观察 可 知 ， 根 据 具体 的 需求 条 件 ， 我 们 可 添加 多 个 配置 文件 。 

记 住 ， 针 对 Git 存储 库 使 用 本 地 文件 系统 仅 用 于 测试 ; 在 生产 环境 中 ， 则 采用 服务 器 
托管 配置 存储 库 。 

下 面 通 过 命令 行 方式 运行 配置 应 用 程序 ， 并 输入 mvn spring-boot:run。 服 务 器 提供 的 
基于 Git 的 配置 API 将 通过 下 列 路 径 进 行 租 询 : 


UU X. XO X X XO Xm Xn 
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l {application}/ {profile} [/{label}] 
/Íapplication]-[profile].»yml 
/(label)/[application]-íprofile].vyml 
/iapplication]-(profile]).properties 
/(label)/[application]-(profile].properties 


对 于 参数 化 的 坏 声 资源， 二 要 理解 下 列 和 变量 : 

OQ 4E {application} PL] 7375? im EH] spring.application.name 属性 值 。 

L1  íprofile3 BL] AAP *n FH] spring.profiles.active 属性 值 。 

Q {label} 引 用 了 Git 分 文 名 称 、 提 交 ID 和 标记 。 

通过 使 用 上 述 URI 可 获取 配置 内 容 ， 下 面 尝 试 对 其 中 的 一 部 分 内 容 进行 检索 。 
J， 如 下 所 示 : 


假设 我 们 的 配置 客户 端 在 分 支 主 服 务 器 的 开发 配置 文件 下 运 # 


/(application]/Ííprofile)[/í1label]] 


前 述 模 式 的 对 应 示例 如 下 所 示 : 


http://localhost:8888/cloudconfig/dev/master 
对 应 输出 结果 如 图 4.4 所 示 。 


[| localhost:8888/cloudcor X A 


e C © localhost:S559S/cloudcontig/dev/master 


1 
name: "cloudconfig , 
profiles: [ 
"dev" 
]; 
label: "master", 
version: "def74dce78f3b96269fd02a0e054eab6d52cb5f6", 
State: null, 
- propertySources: [ 
d 
name: "file:///D:/app-config-repo/application-dev.properties", 
- source: { 


user.role: "Dev" 
1 
J 


图 4.4 
这 里 通过 下 列 URI 检索 当前 配置 。 


/Ííapplication]-([profile].?yml 


。81 。 
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上 述 模式 的 对 应 示例 如 下 所 示 : 


http://localhost:8888/cloudconfig-dev.»yml 


在 图 4.5 中 可 以 看 到 ， 我 们 可 从 云 配 置 应 用 程序 中 获取 此 类 配置 内 容 。 


[| localhost:8888/cloudcor X WA 


€ Q | ®© localhost:8888/cloudconfig-dev.ym 


user: 
role: Dev 


图 4.5 


当前 通过 前 级 文件 使 用 了 本 地 存储 库 ， 这 是 一 种 简单 、 快 速 的 Git 存储 库 应 用 方式 ， 
且 无 须 使 用 服务 器 。 在 该 模式 下 ， 云 服务 器 应 用 程序 在 本 地 Git 存储 库 上 操作 ， 且 无 须 对 
其 进行 克隆 。 但 是 ， 如 果 需 要 通过 高 可 用 性 扩展 Cloud Config Server， 则 需要 使 用 中 央 远 
fE Git 存储 库 ， 而 不 是 直接 使 用 本 地 Git 存储 库 〈 使 用 ssh 协议 或 HTTP 协议 ) 。 这 种 共 
享 的 文件 系统 存储 库 可 被 克隆 ， 并 可 作为 缓存 将 其 用 作 本 地 工作 副本 。 

HTTP 资源 的 {label} 参 数 体现 了 存储 库 实现 的 映射 。 这 里 ，Git 标记 意味 着 提交 ID、 
分 支 名 称 或 标签 。 因 此 ， 如 果 Git 分 支 在 名 称 中 包含 了 一 个 “/”, 那么 ，HTTP 中 的 标记 
将 通过 下 画 线 “″ ”被 解析 ， 而 非 “/”， 进 而 消除 URL 路 径 的 歧义 内 容 。 

rf Hi (application 占 位 符 的 Git FE URL 来 配置 Spring Cloud Config 
Server 应 用 程序 ， 如 下 上 所 未 : 


spring.cloud.config.server.git.uri-https://github.com/dineshonjava/ 


(application) 
类 似 地 ，.yml 文件 中 的 配置 如 下 所 示 : 
spring: 
cloud: 
contig: 
server: 
git: 


Uri: 
https://github.com/dineshonjava/ {application} 
可 以 看 到 ， 上 述 配 置 基 于 “每 个 应 用 程序 一 个 repo” 的 策略 。 
如 果 希 望 在 Spring Cloud 服务 器 应 用 程序 中 使 用 多 个 组 织 ， 那 么 ， 可 采用 下 列 配 置 : 


spring: 


cloud: 
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cont ig: 
server: 
quit 
uti: hbtps://gitrhüb.com/(appti)cat ion] 
内 此 ， 可 在 {application} 参 数 中 使 用 “( )” 并 配置 多 个 组 织 ， 例 如 {application}， 这 
将 在 请 求 时 作为 dineshonjava( )application 予以 提供 。 


46 ”利用 模式 配置 多 个 存储 库 


利用 应 用 程序 和 配置 名 称 的 匹配 模式 ，Spring Cloud Config 还 支持 多 个 存储 库 的 配 
置 。 访 模式 可 通过 多 种 方式 进行 配置 ,例如 逗号 分 阳 的 ,包含 通配符 的 {application}/{profile} 
AKA o 

下 列 模式 配置 用 于 匹配 多 个 存储 库 。 


Spring- 
cloud: 
config: 
server: 
giL- 
uri: https://github.com/dineshonjava/app-config-repo 
repos: 
dev: 
pattern: 
— '*/development' 
= "*J/sragirnq' 
üri: 


https://github.com/dineshonjava/development/app-config-repo 
staging: 
pattern: 
T 
— T*/production'! 
Uri- 


https://github.com/dineshonjava/staging/app-config-repo 

其 中 根据 当前 模式 配置 了 多 个 存储 库 ， 例 如 '*/development'、'*/staging' 和 '*/qa,， 
*/production'。 https://github.conydineshonjava/development/app-config-repo Git URI 用 于 
'*/development', '*/staging' URL 模式 ; https://github.com/dineshonjava/staging/app-config- 
repo Git URI 则 用 于 '*/qa'"，'*/production' URL 模式 。 
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默认 状态 下 ， 当 首次 请 求 配 置 时 ， 服 务 器 将 克隆 远程 存储 库 。 此 外 ， 还 可 进行 适当 
配置 并 在 启动 时 克隆 Git 存储 库 (S cloneOnStart 属性 为 true) ， 如 下 所 示 : 


spring: 
cloud: 
config: 
server: 
git: 
uri: https://github.com/dineshonjava/app-config-repo 
repos: 
dev: 
patteri: 
- '*/development' 
— '*/staging' 
cloneOnStart: true 
E erbe 


https://github.com/dineshonjava/development/app-config-repo 
staging: 
pattern: 
- '*/qga'! 
— F*!pnroduci on" 
cloneOnStart: false 


uri: https://github.com/dineshonjava/staging/app-config-repo 


在 上 述 配置 文件 中 ， 服 务 器 在 启动 时 克隆 了 dev's app-config-repo， 并 于 随后 接收 任意 请 
求 。 男 一 个 存储 库 在 局 动 时 则 未 执行 克隆 操作 , 服务 磺 在 首次 请 求 时 殉 隐 了 app-config-repo。 


4.6.1 号 份 验证 


假设 远程 存储 库 需要 基本 的 授权 验证 进而 对 其 进行 访问 。 对 此 ， 需 要 设置 配置 文件 
中 的 username 和 password 属性 ， 如 下 所 示 : 


spring: 
cloud: 
config: 
server: 
git: 
uri: https://github.com/dineshonjava/app-config-repo 
username: arnav 


password: sweety 


XE, username 和 password 用 于 Git 远程 存储 库 。 如 前 所 述 ，Spring Cloud Config Server 
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将 远程 Git 存储 库 复 制 到 本 地 副本 。 在 一 段 时 间 以 后 ， 由 于 大 量 的 测试 和 开发 ， 存 储 库 的 
本 地 副本 将 变 得 很 “ 脏 ”。 因 此 ，Spring 还 文 持 Git 存储 库 中 的 强制 拉 取 〈force-pull) 。 


4.6.2 force-pull 属性 


HAIS F, force-pull 属性 设置 为 false。 当 然 ， 也 可 将 其 设置 为 true， 以 避免 本 地 
存储 库 变 “ 胜 ”。 考 得 下 列 配置 : 


spring: 
cloud: 
config: 
server: 
git: 
uri: https://github.com/dineshonjava/app-config-repo 
username: arnav 
password: sweety 


force-pull: true 


接 下 来 将 讨论 如 何 实现 Spring Cloud Config Client 应 用 程序 。 
4.7 创建 Spring Cloud 客户 端 


本 节 将 创建 一 个 Spring Boot 应 用 程序 ， 连 接 服 务 占 后 将 利用 中 央 配 置 服务 器 读 取 外 
部 属性 源 。 因 此 ， 对 于 客户 闹 项 目 来 说 ， 需 要 针对 springcloud-starter-config 和 spring- 
boot-starter-web Tt ^ 7l Maven 配置 : 


«dependencies» 

«dependency» 
«grouplId»org.springframework.cloud«c/groupId» 
«artifactlId»spring-cloud-starter-config«/artifactId» 
</dependency> 

<dependency> 
<groupId>org-springframework.boot</groupId> 
<artifactId-spring boot starter web</artiftactId> 
</dependency> 

</dependencies> 


接 下 来 定义 一 个 客户 端 类 ， 即 包含 一 个 GET 方法 映射 的 简单 的 REST 控制 器 ， 如 下 
Bras: 
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package com.dineshonjava.cloudconfigclient; 


import org.springframework.beans.factory.annotation.Value; 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.PathVariable; 


import org.springframework.web.bind.annotation.RestController; 


aRestController 
public class ConfigClientController [ 
QValue ("S$ {user.rolel}™) 
private String role; 
QGGetMapping ("/profile/(name]") 
public String getActiveProfile(GPathVariable String name) { 


return "Hello "-c«name-c-"! active profile name is "-trole; 


} 

Arp, REST 控制 器 类 包含 了 一 个 请 求 处 理 程序 ， 以 及 一 个 one 属性 。 该 属性 通过 
@Value 进行 注解 , 填充 $f{user.role} 值 ， 并 从 http://localhost:8888/ 处 的 Cloud Config Server 
中 被 读 取 。 但 该 属性 须 置 于 名 为 bootstrap.properties 的 资源 文件 中 ， 其 原因 在 于 ， 该 文 
件 在 应 用 程序 局 动 之 前 即 被 载 入 。 下 面 全 看 bootstrap.properties 文件 的 配置 内 221 ， 如 下 
所 示 : 

spring.application.name-config-client 

spring.profiles.active-dev 

spring.cloud.config.uri-http://localhost:8888 

此 处 设置 了 应 用 程序 名 称 、 当 前 配置 文件 ， 以 及 针对 Spring Cloud 服务 器 应 用 程序 
的 连接 信息 。 

假设 Spring Cloud Config Server 应 用 程序 顷 进 行 安 全 配置 ， 那 么 ， 还 需要 包 合 
username 和 password， 进 而 访问 Config Server 应 用 程序 。 下 列 代 码 旺 示 了 包含 安全 配置 
的 bootstrap.properties 文件 。 

spring.application.name-config-client 

spring.profiles.active-dev 

spring.cloud.config.uri-http://localhost:8888 

spring.cloud.config.username-root 

spring.cloud.config.password-s3cr3t 

在 添加 了 安全 配置 以 访问 Config Server Zn. FEITA mM HEF, HEE 
REST 服务 的 输出 结果 ， 如 下 所 示 : 
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package com.dineshonjava.cloudconfigclient; 


import org.springframework.boot.SpringApplication; 


import org.springframework.boot.autoconfigure.SpringBootApplication; 
aSpringBootApplication 
public class CloudConfigClientApplication { 


public static void mairn(String[] args) 1 
SpringApplication-.-run (CloudConfigClientApplication.class, args); 
} 
} 


图 4.6 显示 了 调用 http://localhost:8080/profile/Dinesh REST 后 的 输出 结果 。 


y @ localhost:8080/profile/D x WN 


> 


Hello Dinesh! active profile name is Dev 


图 4.6 


在 图 4.6 中 ， 用 户 的 角色 将 从 Spring Cloud Config Server FER. 
48 A € 


本 章 讨 论 了 原生 云 应 用 程序 及 其 架构 方面 的 问题 。 此 外 ， 本 章 还 介绍 了 微服 务 架构 ， 
并 将 里 体 应 用 程序 分 解 为 独立 的 应 用 程序 组 成 部 分 ， 进 而 强调 有 界 上 下 文 。Spring Cloud 
针对 原生 云 所 涉及 的 诸多 问题 提供 了 相应 的 解决 方案 。 

在 本 章 中 , 我 们 创建 了 一 个 配置 服务 上 器， 并 提供 了 Git 存储 库 到 客户 应 应 用 程序 之 间 
的 一 组 配置 文件 。 其 中 ， 我 们 学 习 了 Spring Cloud 配置 服务 ， 以 及 如 何 构 建 和 使 用 配置 
服务 。 

另外 ， 本 章 还 通过 Spring Cloud Config 探讨 了 配置 服务 及 其 解决 方案 ， 进 而 存储 坏 
境 中 的 配置 ， 并 通过 简单 的 点 到 点 服务 调用 检索 配置 内 容 。 

第 5 章 将 讨论 Eureka Client， 以 及 针对 服务 发 现 的 服务 器 。 


$85 3$ Spring Cloud Netflix 和 
service Discovery 


本 章 将 讨论 Spring Cloud Netflix 和 基于 Eureka 的 Service Discovery. *8 4 9E 34r 28 
了 原生 云 应 用 程序 架构 以 及 与 该 模式 相关 的 各 种 问题 ， 以 及 Spring Cloud 针对 云 应 用 程 
序 的 配 首 定理 所 提供 的 解决 方 采 。Spring Cloud 提供 了 Spring Cloud Config 模块 ， 这 对 于 
管理 分 布 式 应 用 程序 十 分 有 用 ， 例 如 微服 务 。 

除 此 之 外 , 第 3 章 还 实现 了 Spring Cloud Config 服务 器 应 用 程序 ， 同 时 针对 该 Cloud 
Config 服务 器 创建 了 一 个 客户 《使 用 者 ) 。 本 章 将 进一步 考查 Spring Cloud 针对 多 个 分 
布 式 服务 间 通 信 的 文 持 。 

本 章 主 要 涉及 以 下 主题 ， 以 使 谈 者 能 够 更 好 地 理解 基于 Eureka 的 Service Discovery: 

Q Spring Cloud Netflix 简介 。 

口 “ 微 服务 架构 中 的 Service Discovery: 

Q  3J Service Discovery 一 一 Eureka Server: 

> 作为 Discovery Service Server 局 用 Eureka Server. 
Q ”实现 Service Discovery 一 一 Eureka Client: 
> 利用 Eureka 注册 客户 端 。 
使 用 REST 服务 。 
使 用 EurekaClient. 
使 用 DiscoveryClient。 
基于 Netflix Ribbon I] 7& J^? im fa F - 

> 使 用 registry-aware 2x"? 9m. Spring Cloud Netflix FeignClient. 

下 面 将 对 此 逐一 进行 芳 租 。 


Y vY Y Y 


5.1 Spring Cloud Netflix 向 介 


Spring Cloud Netflix 是 Spring Cloud 的 一 个 核心 子 项 目 ， 该 项 目 通 过 Spring Boot 的 
目 动 配置 提供 了 Nettlixz OSS 和 Spring Boot 应 用 程序 之 四 的 集成 。 通 过 Spring Cloud 注解 ， 
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可 构建 对 象 分 布 式 应 用 程序 ， 此 类 注解 将 针对 分 布 式 系统 启用 Netflix 2HfF. Netflix OSS 
针对 分 布 式 应 用 程序 提供 了 多 个 组 件 ， 如 Service Discovery (Eureka) 、Circuit Breaker 

(Hystrix) 、Intelligent Routing (Zuul) 和 Client-Side Load Balancing (Ribbon) 。 本 章 大 
5 VE VP RR) ti Service Discovery. iHi Spring Cloud Netflix Eureka 将 服务 注册 至 
Discovery 服务 器 等 操作 。 

如 前 所 述 ， 分 布 式 原 生 云 系统 是 由 驻 留 在 不 同 服务 左上 的 多 项 服务 所 构建 的 。 对 于 
基于 云 的 应 用 程序 ，Netflix 提供 了 Eureka 服务 器 ， 并 可 视 作 Discovery Service 服务 器 和 
客户 闪 。 其 中 服务 器 Discovery Service 可 将 服务 注册 至 Eureka 云 服务 器 上 ; 客户 疹 Service 
Discovery 使 得 服务 间 彼 此 通信 ， 且 无 须 对 主机 名 和 端口 进行 便 编 码 。 注 册 后 的 服务 需要 
EHP AX m. MERANA E B S BITE TE e 

利用 Netflix Eureka， 可 注册 多 个 服务 ， 以 及 注册 东 项 服务 的 多 个 实例 。 相 应 地 ， 这 
些 注册 服务 实例 可 充当 服务 器 ， 并 将 其 状态 复制 到 连接 的 对 等 客户 六。Netflix Eureka 通 
过 负载 平衡 算法 管理 服务 实例 的 请 求 。 客 户 新 检索 服务 注册 中 心 的 所 有 连接 实例 列表 ， 
并 使 用 负载 平衡 算法 将 负载 分 发 到 这 些 实例 中 ， 这 也 是 Client Side Load Balancing 

(Ribbon〉 所 执行 的 任务 。 

当然 ， 这 也 可 视 为 该 处 理 过 程 的 一 个 缺点 ， 因 为 所 有 客户 机 都 必须 实现 特定 的 逻辑 
来 与 Eureka 的 这 个 固定 点 进行 交互 ， 并 且 在 实际 请 求 之 前 需要 额外 的 网 络 往返 过 程 。 

下 面 答 试 实现 服务 器 疹 的 服务 注册 中 心 (Eureka Server? ,同时 实现 一 个 REST 服务 ， 
并 将 其 自身 在 该 注册 中 心 (Eureka Client) 进行 注册 ， 具 体 如 下 : 

Q SEIL Service Discovery —— Eureka Server. 

Q  3J Service Discovery 一 一 Eureka Client. 

本 章 主 要 讨论 针对 微服 务 方面 的 支持 ， 即 Service Discovery。 接 下 来 将 讨论 微服 务 项 
H F Service Discovery 方面 的 内 容 。 


52 ”微服 务 架 构 中 的 Service Discovery 


在 微服 务 架 构 中 ， 服 务 彼 此 连接 过 程 中 可 能 会 使 用 到 各 种 协议 。 但 是 ， 这 些 服务 如 
何 发 现 彼此 间 的 存在 呢 ? 

另外 ， 某 个 服务 可 能 包含 多 个 实例 。 因 此 ， 如 果 运 行 多 个 实例 ， 状 况 又 当 如 何 ? 对 
Jt, "REB 5.1. 

可 以 看 到 ， 存 在 两 个 服务 运行 于 微服 务 应 用 程序 中 ， 即 Account Service 和 Customer 
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Service. Account Service 请 求 Customer Service 以 获取 JSON 格式 的 客户 记录 。 同 时 ， 两 
项 服务 均 包 含 上 自身 的 数据 库 访 问 ， 分 别 为 Account DB 和 Customer DB。 除 此 之 外 ， 考 虑 
到 高 可 用 性 和 吞吐 量 ，Customer Service 包含 了 多 个 运行 实例 ， 以 使 其 更 具 弹 性 。 这 里 的 
问题 是 ，Account Service 如 何 调 用 Customer Service? 哪 一 个 实例 将 被 最 终 调用 ? 


通过 服务 发 现 获取 服务 针对 吞吐 量 和 弹性 
及 其 运行 实例 


| e T" | 的 多 个 实例 
哪 一 个 实例 ? | | 
REST 请 求 | | 


Customer Service 


Account Service 


JSON 


Accou nt DB Customer DB 
. MySQL DB2 | 


图 5.1 


为 了 回合 上 述 问 感 ， 


Service Discovery Miz mÆ, 并 人 负 贡 处 理 此 类 问题 ,在 此 基础 上 ， 
4 ER 5.2。 


步骤 4 
注册 Account — 步骤 3 | 步骤 2 


Service — 发 现 Customer Service 注册 Customer Service 


REST 请 求 
Account Service 步骤 4 生成 请 求 Customer Service 
JSON 


Customer DB 
DB2 | 


Account DB 
MySQL 
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其 中 ， 发 现 服务 占用 于 注册 微服 务 ， 并 在 使 用 微服 务 时 进行 咨询 ， 上 县 体 工作 流程 如 
下 所 示 : 
(1) Account Service 利用 Eureka Discovery Server 对 其 上 自身 进行 注册 。 
(2) 同样 ，Customer Service 也 利用 Eureka Discovery Server 对 其 目 身 进行 注册 。 
(3) Account Service 咨询 Discover Server LRI Customer Service. 
(4) Account Service 知晓 被 调用 的 Customer Service Sz fl . 
发 现 服务 解决 了 微服 务 架 构 中 的 原生 云 问 题 。Spring Cloud 文 持 Service Discovery 的 
多 种 实现 ， 例 如 Netflix Eureka 和 Hashicorp Consuls HPE AREA TER, Spring Cloud 
简化 了 此 类 服务 器 的 使 用 。 本 章 将 讨论 Netflix Eureka Service Discovery 及 其 实现 。 


53 ”实现 Service Discovery———Eureka Server 


本 节 将 实现 针对 服务 注册 中 心 的 Eureka Server。 对 此 ， 可 加 对 应 依赖 关系 中 添加 
spring-cloud-starter-eureka-server， 该 操作 过 程 较为 简单 。 下 列 Maven 配置 将 针对 服务 注 
册 中 心 筹建 Eureka 服务 器 。 


5.3.1 Maven 构建 配置 文件 


考查 pom.xml 文件 中 的 下 列 配置 内 容 。 


<parent> 
«grouplId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-parent«/artifactld» 
«version»2.0.2.RELEASE«/version» 
«relativePath/» «!-- lookup parent from repository 一 一 > 
«/parent» 


«properties» 
«project.build.sourceEncoding»UTF-8«/project.build.sourceEncoding» 

«project.reporting.outputEncoding»UTF-8«/project.reporting.outputEncoding» 
«java.version»1.8«/java.version» 
«spring-cloud.version»Finchley.M7«/spring-cloud.version» 


«/properties» 


«dependencies 
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«dependency» 
«groupld»org.springframework.cloudc/groupId» 
XartifactlId»5spring-cloud-starter-netflix-eurekaserverc«/artifactld» 


</dependency> 


<dependency> 
«groupld»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 

</dependency> 


</dependencies> 


<dependencyManagement> 
«dependencies» 

«dependency» 
«groupId»org.springframework.cloud«c/groupId» 
«artifactlId»spring-cloud-dependencies«c/artifactld» 
«version»$[spring-cloud.version]c/version» 
«type»pom«/type» 

«scope»import«c/scope» 
</dependency> 
</dependencies> 


</dependencyManagement> 


如 果 应 用 程序 为 build.gradle WH, M TRZA build.gradle 文件 。 
5.3.2 ”Gradle 构建 配置 文件 


考 全 下 列 配置 内 容 : 


apply plugin: 'java' 
apply plugin: 'eclipse' 
apply plugin: 'org.springftramework.boot!' 


apply plugin: 'io.spring.dependency-management'l 
group — 'com.dineshonjava' 
version ~ *'D.D0.1-5NAPSHOT' 


sourceCompatibility = 1.8 


repositories 1 


mavenCentral () 
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maven { url "https://repo.spring.io/snapshot" } 


maven { url "https://repo.spring.io/milestone" } 


ext | 
springCloudVersion - 'Finchley.M7' 


dependencies 1 
compile('org.springtramework.celoud-spring- cloud-starter-netrivx- 
eurekaserver') 


LestCompile('org.springframework.boot:spring-boot-starter-test"') 


dependencyManagement | 
imports { 
mavenBom "org.springframework.cloud:spring-clouddependencies: 
S(springCloudVersion]" 
} 
} 


通过 pom.xml Maven 配置 文件 和 build.gradle Gradle 配置 文件 ， 我 们 利用 
org.springframework.cloud 分 组 和 spring-cloud-starter-netflix-eureka-server 工件 ID 添加 了 
starter. iZ starter 同 服 务 注册 中 心 提供 了 与 Netflix Eureka 服务 器 相关 的 目 动 配置 。 

但 在 默认 状态 下 ，Eureka 服务 器 并 未 开局 。 因 此 ， 需 要 在 Spring Boot 主 应 用 程序 类 
rH GEH GSpringBootApplication 进行 注解 ) 通过 @EnableEurekaServer 注解 后 用 Eureka 
HR aS dà o 


53.3 AH Eureka 服务 器 作为 Discovery Service 服务 器 
考查 下 列 Spring Boot 中 的 main 应 用 程序 类 ， 如 下 所 示 : 
package com.dineshonjava.eurekaserver; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 


import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer; 


aSpringBootApplication 


üQEnableEurekaServer 
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public class EurekaServerApplication { 


public static void main(S5tring[|| args) | 
SpringApplication.run(EurekaServerApplication.class, args); 
} 
| 


当 运 行 上 述 main 应 用 程序 类 时 ， 将 局 用 Eureka Server。 该 服务 器 包含 了 UIER, 
同时 还 针对 /eureka/* 下 的 一 般 功 能 包含 了 HTTP API who SAHT, RED Eureka 服务 器 
也 是 一 个 Eureka 客户 端 。 因 此 ， 还 可 将 registerWithEureka 设置 为 false， 以 禁用 这 一 默认 
的 Eureka 服务 器 客户 剖 注 册 中 心 。 

考查 下 列 Eureka 服务 器 的 application.yml 文件 : 


Server: 
port: B761 

eureka: 
instance: 


hostname: localhost 
client: 
registerWithEureka: false 
fetchRegistry: false 
ServiceUrl: 
defaultZzone: 


http://S$[eureka.instance.hostname]:S$[(server.port]/eureka/ 


这 里 , application.yml 定义 为 一 个 配置 文件 , 进而 配置 YAML 格式 的 属性 。server.port 
属性 定义 了 Eureka 服务 左 问 口 ， 此 处 ， 该 应 用 程序 端口 配置 为 8761， 同 时 也 是 Eureka 
RARR A mO. Byk, KELA Eureka 服务 器 实例 的 主机 名 配置 为 localhost。 由 于 
当前 应 用 程序 应 为 一 个 服务 器 ， 因 而 须 通 知 内 建 Eureka 客户 新 不 要 进行 目 里 的 注册 。 同 
时 ，serviceUrl 指 回 了 与 本 地 实例 相同 的 主机 。 

最 后 ， 可 在 浏览 器 中 访问 http://localhost:8761， 并 查看 Eureka 所 显示 的 仪表 盘 ， 如 
图 5.3 所 示 。 

当前 尚 不 存在 任何 注册 后 的 服务 实例 ， 稍 后 将 对 此 加 以 讨论 。 此 时 仅 可 看 到 一 些 基 
本 的 指示 费 ， 例 如 状态 和 健康 指示 如 。 

接 下 来 讨论 如 何 创建 一 个 Eureka 客户 端 和 REST 服务 ， 并 将 该 服务 在 注册 中 心服 务 
ü& LETT EMI e 
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©) spring = U re k a HOME LAST 1000 SINCE STARTUP 


System Status 


2018-03-D3TOO-00- 1D -0530 


OD 03 
false 
3 


ü 
DS Replicas 


Instances currently registered with Eureka 


SPRIMG-CLOLID-ELUREKA-CLIENT 


General Info 


environment 
num-of-cpus 
current-memory-usage b9mb [15%] 


mr 
00:03 


unawailable-replicas 


available-replicas 
Instance Info 
Name 


ipAddr 


status 


54 实现 Service Discovery — Eureka & P 3a 


Service Discovery 是 微服 务 架 构 中 的 核心 模式 之 一 。Spring Cloud 通过 Netflix OSS 
Eureka 提供 了 Service Discovery 功能 。 相 应 地 ，Eureka 表示 为 Cloud Service Discovery 
Server 和 Client。 在 前 述 内 容 中 ， 我 们 讨论 了 如 何 实现 Netflix Service Discovery 服务 器 ， 
本 节 将 实现 Netflix Service Discovery 7 J^ "ifj « 


54.1 添加 Maven 依赖 关系 配置 


当 在 项 目 中 实现 Eureka Client 时， 需要 通过 org.springframework.cloud 分 组 和 id 
spring-cloud-starter-netflix-eureka-client 包含 Spring Cloud Starter。 除 此 之 外 ， 还 应 在 pom.xml 
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文件 中 包含 spring-boot-starter-web. SEL REST 控制 器 、 创 建 简单 的 REST 服务 并 通过 
Eureka Discovery Server 进行 注册。 和 考 到 下列 Maven 配置 文件 : 


<parent> 
«groupld»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-parent«/artifactId» 
«version»2.0.2.RELEASE«/version» 
«relativePath/» «!-- lookup parent from repository 一 一 > 
«/parent» 


«properties» 
«project.build.sourceEncoding»UTF-8«/project.build.sourceEncoding» 

«project.reporting.outputEncoding»UTF-8«/project.reporting.outputEncoding» 
«java.version»1.8«/java.version» 
«spring-cloud.version»Finchley.M7«/spring-cloud.version» 


«/properties» 


«dependencies» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 
</dependency> 
<dependency> 
<groupId>org.springİramework.cloud</groupId> 
<artifactId>spring-cloud-starter-netflix-eurekaclient</artifactId> 
</dependency> 


<dependency> 
<grouplId>org.springframework.boot</groupld> 
«artifactId»spring-boot-starter-test«/artifactlId» 
«scope»test«/scope» 
</dependency> 
</dependencies> 


<dependencyManagement> 
<dependencies> 
<dependency> 

<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-dependencies</artifactId> 
«version»$í(spring-cloud.version]«c«/version» 
«type»pomcz/type» 
«scope»importc«/scope» 
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«/dependency» 
«/dependencies» 
«/dependencyManagement» 


其 中 添加 了 两 项 依赖 关系, 分别 对 应 于 Spring Web {HJ Spring Cloud Netflix Eureka 
客户 端 。 除 此 之 外 , 还 可 将 该 应 用 程序 选 为 Gradle MH. 下面 考查 build.gradle 文件 配置 。 


54.2 Gradle 构建 配置 


考 得 下 列 配置 内 容 : 

apply pluqin: "'java' 

apply plugin: 'eclipse' 

apply plugin: 'org.springframework.boot' 


apply plugin: 'io.spring.dependency-management' 


group — 'com.dineshonjava' 
version = 'gQ-0-1-5NAPSHOT' 
sourceCompatibility = 1.8 


repositories 1 
mavenCentral() 
maven ( url "https://repo.spring.io/snapshot" } 


maven { url "https://repo.spring.io/milestone" } 


ext I 
springCloudVersion = 'Finchley.M7' 


dependencies 1 
compile('org.springframework.boot:spring-boot-starter-web') 
compile('org.springframework.cloud:spring-cloud-starter-netflix-eur 

ekaclient') 
LestCompile('org.springframework.boot:spring-boot-starter-test"') 


dependencyManagement { 
imports { 
mavenBom "org.springframework.cloud:spring-clouddependencies: 
SÍíspringCloudVersionj]" 
} 
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该 文件 包含 了 Spring Web 模块 和 Spring Cloud Netflix Eureka 2s J? 5m [x RAKERA- 
接 下 来 利用 Eureka 注册 客户 端 。 


55 利用 Eureka i AR P 35 


利用 Eureka 73:70] 2 J^ "ij 3x PE 2) Yita vhi e p D El AATE, PLAUT BL TS im E188] 3L 
A. RRS i URL 以 及 主页 。 另 外 ， 每 个 服务 实例 将 加 Eureka 服务 器 发 送 消息 ; 
如 果 Eureka 未 通过 配置 时 间 表 接收 该 消息 ， 对 应 实例 一 般 将 从 注册 中 心 处 被 移 除 。 

下 面 定 义 一 个 main 应 用 程序 类 ， 并 针对 该 客户 产 应 用 程序 采用 @SpringBootApplication 
进行 和 注解。 默认 状态 下 ，Spring Discovery Client. 处 于 禁用 状态 ， 因 而 需要 通过 
(QEnableDiscoveryClient 或 @EnableEurekaClient 予以 启用 。 下 列 内 容 显 示 了 Eureka 客户 
9m zv PA RO: 


package com.dineshonjava.eurekaclient; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 


import org.springframework.cloud.netflix.eureka.EnableEurekaClient; 


aSpringBootApplication 
aEnableEurekaClient 
public class EurekaClientApplication f 


public static void main(Stringl[]l args) 1{ 


Spring^Appircation.run(burekaClientAppi:cation.class, args); 


} 
接 下 来 创建 一 个 REST 服务 ， 并 通过 Eureka 服务 器 进行 注册 ， 如 下 所 示 : 


package com.dineshonjava.eurekaclient; 


import org.springframework.web.bind.annotation.GetMapping; 


import org.springframework.web.bind.annotation.RestController; 


aRestController 

public class HelloController 1{ 
QGetMapping ("/hello") 
public String qgqreetingt) { 
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return "Hello to the Dineshonjava from EurekaClient!"; 


下 面 针 对 该 客户 端 应 用 程序 以 application.yml 文件 形式 创建 一 个 应 用 程序 配置 , 如 下 
Bra: 
spring: 


application: 


name: spring-cloud-eureka-client 


server: 
pört: BU 


eureka: 
client: 
serviceUrl: 
defaultZone: $[EUREKA URI:http://localhost:8761/eureka] 
instance: 


preferIpAddress: true 

该 配置 文件 包含 了 Spring 应 用 程序 名 称 ， 并 可 在 注册 应 用 程序 列表 中 唯一 地 识别 客 
Pino BREZ Sh 文件 中 还 设置 了 服务 器 关口 80。 当 然 ， 我 们 也 可 令 Spring Boot 选择 一 
个 随机 站 口 一 一 稍 后 将 利用 其 名 称 访 问 对 应 服务 。 最 后 ， 还 需要 通知 客户 冰 注 册 中 心 所 
处 的 具体 位 置 。 

接 下 来 运行 客户 端 应 用 场合 ， 并 再 次 在 浏览 器 中 访问 http:/localhost:8761。 在 Eureka 
Dashboard 中 ， 可 以 看 到 各 户 交 的 注册 状态 ， 如 图 5.4 所 示 。 

由 图 5.4 可 以 看 到 ， 其 中 包含 了 一 个 REST 服务 注册 实例 。 该 注册 服务 名 称 为 
SPRING-CLOUD-EUREKA-CLIENT， 这 一 点 可 以 在 配置 文件 的 应 用 程序 名 称 选项 中 看 
f|, 535^, An RA home-page-url、health-check-url、statuspage-url-path， 如 下 所 示 : 

spring: 

application: 


name: spring-cloud-eureka-client 


server: 
pört: 80 


eureka: 
client: 
service-url: 
default-zone: $(EUREKA URI:http://localhost:8761/eureka] 
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instance: 
prefer-ip-address: true 
status-page-url-path: https://S[eureka.instance.hostName]/info 
health-check-url: https://S$[eureka.instance.hostName]/health 
home-page-url: https://S(eureka.instance.hostName]/ 


(D spring Eureka Hou 


LAST 1000 SINCE STARTUP 


System Status 


Environment 


test Current time 2018-03-03TO00-00: 10 -0530 
Data center defaulr Uptime 00-03 
Lease expiration enabled false 
Renews threshold 3 
Renews (last min} N 


DS Replicas 


Instances currently registered with Eureka 


Application AMIsS Availability Zonas 


SPRING-CLOUD-EUREKA CLIENT n/a (1) (1] 


General Info 


Name Value 
rotal | mory 过 王立 
environment test 


current-mernory-usacae 9mb (1535) 


server-uptime 00:03 
registered-replicas 


unawvailable-replicas 


evailable-replicas 


Instance Info 


图 5.4 
Eureka 在 内 部 为 状态 和 主页 注册 这 些 属性 , 并 为 状态 和 主页 发 布 一 个 不 安全 的 URL. 
在 上 述 配 置 文件 中 ， 我 们 有 如 式 地 和 曹 载 了 这 些 属 性 ， 以 确保 HTTP 协议 的 安全 。 
$ {eureka.instance.hostName} 属 性 将 从 eureka.instance 属性 下 定义 的 主机 名 中 了 予以 解析 。 男 
外 ， 还 可 通过 坏 境 变量 (例如 eureka.instance.hostname=$ {HOST NAME?) 在 运行 期 内 设 
置 主机 名 。 
下 面 使 用 注册 于 Eureka 服务 器 上 的 微服 务 。 


M HESS. 
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55.1 使 用 REST 服务 


本 节 将 通过 多 种 方式 使 用 托管 于 Eureka Server EH] REST 服务 .下 面 通过 com.netflix. 
discovery.EurekaClient 创建 一 个 使 用 REST 服务 的 Web 应 用 程序 。 


552 使 用 EurekaClient 


此 处 将 定义 一 个 HomeController 类 ， 并 目 动 连接 com.netflix.discovery.EurekaClient， 


如 下 所 示 : 


package com.dineshonjava.eurekaclient; 


import 
import 


import 


import 
import 


import 


org.springframework.beans.factory.annotation.Autowired; 


org.springframework.web.bind.annotation.GetMapping; 


org.springframework.web.bind.annotation.Controller; 


com.netflix.appinfo.InstanceInfo; 
com.netflix.discovery.EurekaClient; 


com.netflix.discovery.shared.Application; 


Controller 


public 


class HomeController { 


G@Autowired 


private EurekaClient eurekaClient; 


public String serviceUrl() | 


Application application = eurekaClient.getApplication("spring- 


cloudeureka-client").- 


} 


Instancelnfo instanceInfo = application.getInstances () . get (0) ; 
String hostname = instancelInfo.getHostName(); 

int port = rnstanceinto-getPort(): 

// we can find many information related to the instance 


return instanceInfo.getHomePageUrl(); 


此 处 将 EurekaClient 置 入 控制 器 中 ， 据 此 ， 可 作为 Application 对 象 并 通过 服务 名 称 
接收 服务 信息 。 
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LES 
建议 不 要 在 @PostConstruct Su) Scheduled 方法 中 使 用 EurekaClient， 其 原因 在 于 ， 它 在 
SmartLifecycle 中 被 初始 化 (phase=0 ) o RFH TARSAT E ai SmartLifecycle 中 。 


默认 时 ，EurekaClient 针对 HTTP 通信 使 用 Jersey。 但 是 ， 可 从 Maven 依赖 项 中 排除 
Jersey， 从 而 避免 使 用 Jersey» Spring Cloud 将 目 动 配置 Spring 的 org.springframework.web. 
client.RestTemplate 模板 。 同 时 ，Spring Cloud 还 提供 了 本 地 Netflix EurekaClient I] 8 V7; 
案 。 因 此 ， 如 果 不 打 算 使 用 本 地 Netflix EurekaClient, Spring Cloud 还 将 支持 Feign 和 
RestTemplate， 二 者 均 采 用 逻辑 Eureka 服务 标识 符 ， 而 非 物理 URL. 

1. 使 用 DiscoveryClient 

对 于 REST 服务 的 使 用 ，Spring Cloud 还 提供 了 org.springframework.cloud.client. 
discovery.DiscoveryClient. DiscoveryClient Ej Netflix 则 并 无 关联, R ADS] AGIR P imu 
供 了 一 个 简单 的 API。 考 得 下 列 示 例 代 码 : 


package com.dineshonjava.eurekaclient; 

import java.net.URIT; 

import java.util.List; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.cloud.client.ServiceInstance; 

import org.springframework.cloud.client.discovery.DiscoveryClient; 
import org.springframework.web.bind.annotation.GetMapping; 

import org.springframework.web.bind.annotation.Controller; 
aController 

public class HelloController í( 

GAutowired 

private DiscoveryClient discoveryClient; 

public URI serviceUrl() f 

List<Servicelnstance> list = discoverytliont.getinstances("spring- 
clLloudeureka- client"): 

1f {list t= nut wh IT51-50)7v6f) > D I 

return list.get(0).getUri(); 

} 

return nulti; 


} 
上 述 示 例 采 用 了 DiscoveryClien 获取 实例 的 URL， 根 据 对 应 的 URL， 可 利用 Spring 
的 RestTemplate 使 用 当前 REST 服务 。 
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鉴于 当前 这 一 类 客户 端 将 返回 与 Eureka 注册 服务 相关 的 信息 ， 因 而 不 宜 采 用 
EurekaClient 或 DiscoveryClient. 2%, 15 4|H] RestTemplate 或 HttpClient 调用 此 类 服 
务 。 通 过 显 式 方 式 ， 我 们 还 需要 对 此 类 服务 的 加 载 予以 管理 。 针 对 于 此 ，Spring Cloud 
Netflix Ribbon 可 用 于 管理 加 载 行为 ， 并 可 视 为 Cloud 应 用 程序 中 的 负载 平衡 右 。 

本 章 将 探讨 微服 务 染 构 上 与 客户 问 负 和 载 平 衡 相关 的 一 些 细 节 内 容 。 之 前 曾 采 用 
Service Discovery 实现 了 服务 间 的 通信 和 获取 ， 接 下 来 将 讨论 基于 Neflix Ribbon 的 客户 
病人 负载 平衡 。 

2. 基于 Neflix Ribbon 的 客户 端 负载 平衡 

客户 疹 负 载 平 衡 用 于 平衡 微服 务 的 输入 负载 每 项 服务 一 般 会 作为 多 个 实例 被 部 
车。 因此 ， 对 于 容错 和 负载 共 译 ， 如 何 决 定 使 用 哪 一 个 服务 实例 ? 

客户 闹 人 负载 平衡 实现 提供 了 一 种 方式 可 在 多 个 实例 间 分 配 负 载 。 其 间 ，Discovery 
Server 将 负责 返回 多 个 实例 的 相关 位 置 。 这 里 ， 多 个 实例 仅 用 于 弹性 和 负载 共享 ， 但 客 
户 闪 只 需要 选择 服务 的 一 个 实例 。 因 此 ，Spring Cloud Netflix Ribbon 将 针对 客户 病 负 载 
平衡 机 制 提供 多 种 算法 。 此 外 ，Spring 还 提供 了 一 个 智能 RestTemplate。 

Spring 的 RestTemplate 是 一 个 智能 客户 端 , 可 调用 在 Eureka 服务 器 上 注册 的 微服 务 ， 
并 可 上 自动 集成 两 个 Netflix LE, 例如 Eureka Service Discovery 和 Ribbon 客户 端 负载 平衡 
器 。 同 时 ，Eureka 将 返回 全 部 有 效 实例 的 URL。 相 应 地 ，Ribbon 负责 决定 可 用 的 最 优 服 
务 。 通 过 @LoadBalanced 注解 ， 可 注入 负载 均衡 的 RestTemplate。 此 外 ，Spring Cloud 提 
供 了 @LoadBalanced 注解 ， 其 中 包含 了 内 建 的 Service Discovery 以 及 负载 平衡 机 制 。 通 过 
使 用 注册 后 的 微服 务 的 逻辑 服务 名 ，Service Discovery 可 视 为 一 类 自动 查询 操作 。 

下 列 代 码 显 示 了 针对 Ribbon 的 Maven 依赖 天 系 : 


«dependencies» 


<dependency> 

«grouplId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-web«/artifactId» 
</dependency> 

<dependency> 

«grouplId»org.springframework.cloud«c/groupId» 
«artifactlId»spring-cloud-starter-netflix-eureka-client«/artifactid» 
</dependency> 

<dependency> 

«groupld»org.springframework.cloudc/groupId» 
«artifactlId»spring-cloud-starter-netflix-ribbon«x/artifactId» 
</dependency> 
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«/dependencies» 


可 以 看 到 ，spring-cloud-starter-netflix-ribbon starter 将 回应 用 程序 添加 Ribbon JÆ, H 
中 包 售 了 已 添加 的 starter， 进 而 创建 一 个 Web 应 用 程序 ， 并 将 该 程序 作为 一 项 服务 注册 
T Eureka， 例 如 springboot-starter-web 和 spring-cloud-starter-netflix-eureka-client. 

Ribbon 是 一 个 客户 站 负载 平衡 左 ， 并 可 全 面 操控 HTTP 和 TCP 客户 端 。 相 应 地 ， 
RestTemplate 将 被 目 动 配置 进而 使 用 Ribbon。 当 创建 一 个 负载 平衡 的 RestTemplate 时 ， 
可 生成 一 个 @Bean RestTemplate， 并 使 用 @LoadBalanced 标识 从， 如 下 所 示 : 


package com.dineshonjava.ribbonclient; 

import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.cloud.client.loadbalancer.LoadBalancedg; 
import org.springframework.cloud.netflix.eureka.EnableEurekaClient; 
import org.springframework.context.annotation.Bean; 

import org.springframework.web.client.RestTemplate; 
aSpringBootApplication 

aEnableEurekaClient 

public class RribbonClientApplicatugon 1 

public static void main(String[] args) 1 
SpringApplication.run(RibbonClientApplication.class, args); 

} 

GBean 

GLoadBalanced 

public RestTemplate restTemplate() I 

return new RestTemplate(); 

} 

} 


XE, main 应 用 程序 类 针对 RestTemplate 定义 了 一 个 Bean。 如 果 硕 望 在 应 用 程序 中 
使 用 RestTemplate， 则 需要 针对 RestTempplate 定义 一 个 Bean 方法 ， 其 原因 在 于 ， 
RestTempplate Bean 不 再 明 过 目 动 配置 创建 ， 且 需要 通过 独立 的 应 用 程序 加 以 创建 。 

下 面 利 用 该 RestTempplate 生成 一 项 服务 ， 并 调用 利用 Eureka 注册 的 该 项 服务 ， 如 
下 所 示 : 

package com.dineshonjava.ribbonclient.service; 

import org.springframework.beans.factory.annotation.Autowired; 

import org.springframework.cloud.client.loadbalancer.LoadBalancedg; 

import org.springframework.stereotype.Service; 

import org.springframework.web.client.RestTemplate; 


(Service 
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public class HelloServiceClient | 

aQAutowired 

aLoadBalanced 

RestTemplate restTemplate; 

public String sayHello()1 

return restTemplate.getForObject ("http: //SPRING-CLOUD-EUREKA-CLIENT/hello", 
sString.class); 

} 

} 


可 以 看 到 ， 这 里 目 动 载 入 了 负载 平衡 的 RestTemplate 以 调用 服务 。RestTemplate 是 
一 个 HTTP 客户 端的 高 层 实现 ,并 公开 了 多 个 方法 以 调用 服务 ,但 对 应 方法 需要 一 个 URI。 
相应 地 ，URI 须 使 用 一 个 作为 服务 名 的 虚拟 主机 名 ， 而 非 主机 名 。 
下 面 考查 应 用 程序 配置 类 application.yml， 如 下 所 示 : 
spring: 
application: 


name: spring-cloud-ribbon-client 


server: 
port: 8181 


eureka: 
client: 
service-url: 
default-zone: ${EUREKA URI:http://localhost:8761/eureka] 
instance: 


prefer-ip-address: true 
上 述 配置 文件 将 应 用 程序 名 定义 为 spring-cloud-ribbon-client， 将 服务 器 端口 定义 为 
8181， 其 他 配置 内 容 与 之 前 相 比 保持 不 变 。 
利用 http:/localhost:8761/ 打 开 浏览 右 ， 并 运行 客户 站 应 用 程序 ， 对 应 结 末 如 图 5.5 所 示 。 
DS Replicas 


Instances currently registered with Eureka 


Application AMIS Availability Zones 


SPRING-CLOUD-EUREKRKA-CLIENT n/a (1) (1) 


SPRING-CLOUD-RIBBON-CLIENT n/a (1) (1) 


图 5.5 所 示 的 Eureka Dashboard 中 显示 了 两 项 服务 ,， 且 分 别 注 册 为 SPRING-CLOUD- 
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EUREKA-CLIENT 和 SPRING-CLOUD-RIBBON-CLIENT. 
随后 ， 在 浏览 器 中 访问 http://localhost:8181/say-hello， 对 应 结果 如 图 5.6 所 示 。 


Ø Say Hello Page|Dineshc x W 3 


E © | © 192.168.56.1:8181/say-hello 


Hello to the Dineshonjava from EurekaClient! 


图 5.6 


其 中 ，RestTemplate 调用 Eureka 注册 的 SPRING-CLOUD-EUREKA-CLIENT 服务 ， 
进而 得 到 “Hello to the Dineshonjava from EurekaClient!” 字 符 串 。 

Spring Cloud 还 支持 内 部 实现 了 负载 平衡 功能 的 为 一 个 客户 闹 。 下 面 将 对 此 加 以 讨 
论 ， 这 里 不 需要 获取 关于 服务 实例 (如 URD 的 信息 ， 只 需 给 出 应 用 程序 名 称 即 可 。 


9.0.9 Feign Client 


本 节 将 考查 一 个 与 Feign Client 相关 的 简单 示例 ,第 8 章 还 将 对 此 加 以 深入 讨论 .Feign 
Client 是 一 个 基于 接口 的 discovery-aware RestTemplate， 进 而 实现 端点 间 的 通信 。 此 外 ， 
Feign Client 还 是 一 个 注册 服务 器 感知 的 客户 端 ， 并 被 用 作 Discovery-server-aware 
RestTemplate， 使 用 市 有 服务 六 点 的 接口 进行 明 信 。 相 应 地 ， 此 类 接口 将 在 运行 期 目 动 实 
现 。 注 意 ，Spring Cloud Netflix Feign Client 使 用 了 services-names， 而 非 service-urls。 


LES 
Feign 已 经 使 用 了 Ribbon。 因 此 ， 如 果 正 在 使 用 @FeignClient， 这 里 将 不 会 产生 任何 


ub oz 
冲 大 


下 和 面 碍 看 一 个 与 Feign Client 相关 的 简单 示例 。 自 先 在 应 用 程 订 上 人 设 普 Feign Client. 
对 此 ， 需 要 在 pom.xml 上 添加 下 列 依赖 关系 : 


«dependencies» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
XartifactId»spring-boot-starter-web«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.cloud«/groupId» 
«artifactlId»spring-cloud-starter-netflix-eurekaclient«/artifactId» 

</dependency> 
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«dependency» 
«groupId»org.springframework.cloud«/groupId» 
«artifactlId»spring-cloud-starter-openfeign«c«/artifactld» 
</dependency> 


</dependencies> 


其 中 同 pom.xml FSI f 4 7 Maven 依 顿 天 系 , IAE spring-cloud-starter-openfeign、 
spring-cloud-starternetflix-eureka-client, spring-boot-starter-web 和 spring-boot-starter-thymeleaf. 
EHF, spring-cloud-starter-openfeign 提供 了 Feign client。 下 面 查 看 下 列 Feign Client 接口 : 


package com.dineshonjava.feignclient.service; 


import org.springframework.cloud.openfeign.FeignClient; 


import org.springframework.web.bind.annotation.GetMapping; 


aFeignClient ("spring-cloud-eureka-client") 
public interface HelloServiceClient { 
QGetMapping ("/hello") 
String sayleltiot):; 
} 


在 当前 示例 中 ， 该 接口 定义 了 一 个 包含 @GetMapping 注解 的 方法 。 此 外 ， 访 接口 还 
采用 了 一 个 包含 spring-cloud-eureka-client 服务 名 的 @FeignClient 注解 加 以 标注 。 鉴 于 
Spring 将 在 运行 期 内 执行 ， 因 而 此 时 无 须 实现 该 接口 。 但 需要 记 住 ， 仅 当局 用 了 Spring 
Cloud Netflix Feign Client 后 ，@FeignClient 注解 方 可 正常 工作 ， 即 使 用 配置 类 OB 
@Configuration 加 以 注解 〉) 上 的 @EnableFeignClients 注解 。 


package com.dineshonjava.feignclient; 


import org.springframework.boot.SpringApplication; 


import org.springframework.boot.autoconfigure.SpringBootApplication; 


import org.springframework.cloud.netflix.eureka.EnableEurekaClient; 


import org.springframework.cloud.openfeign.EnableFeignClients; 


aSpringBootApplication 
aEnableEurekaClient 
aEnableFeignClients 

public class FeorgnclientApplicatron. 1{ 


pubtic static void marn(String[] arqs) i 
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opringApplication-runiFeignclientApplication.class, args); 


} 


可 以 看 到 ，main 应 用 程 厅 过 过 3 个 注解 予以 标注 ， 即 @SpringBootApplication、 
@EnableEurekaClient 和 @EnableFeignClients。 其 中 ,@SpringBootApplication 用 于 与 Spring 
Cloud 关联 的 目 动 配置 ，@EnableEurekaClient 用 于 将 该 应 用 程序 注册 为 Eureka 服务 器 的 
一 项 服务 ;最 后 ,注解 @EnableFeignClients H FJA JH Spring Cloud 应 用 程序 的 Netflix Feign 
模块 。 

下 面 创建 一 个 应 用 程序 控制 占 类 ， 并 将 Feign Client f O HJER EZ hE, Un 
下 所 示 : 


package com.dineshonjava.feignclient.controller; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 
import org.springframework.ui.ModelMap; 


import org.springframework.web.bind.annotation.GetMapping; 
import com.dineshonjava.feignclient.service.HelloServiceClient; 


aController 
public class HelloWebController { 
QAutowired 
HelloServiceClient helloServiceClient; 
QGetMapping ("/say-hello") 
String sayHello(ModelMap model)|í 
model.put("message", helloServiceClient.sayHello()); 
return "hello": 


} 


这 里 , Web 控制 器 定义 了 一 个 请 求 处 理 方法 , 即 sayHello0。 该 方法 将 利用 Feign Client 
(HJ HelloServiceClient) 返回 的 消息 填充 模型 对 象 ， 并 从 REST 服务 中 获取 数据 。 此 处 ， 
starter 的 依 顿 关系 〈 如 springboot-starter-web 和 spring-boot-starter-thymeleaf) 用 于 显示 一 
个 视图 。 
针对 当前 Web 应 用 程序 示例 ， 对 应 视图 如 下 所 未 : 
<!DOCTYPE html» 


«html xmlns:th-"http://www.thymeleaf.org"» 
«head» 
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«title»Say Hello Page | Dineshonjava.com«c/title» 
</head> 
<body> 
<h2 th:text-"Sí(message)"/» 
</body> 
</html> 


这 表示 为 thymeleaf 视图 文件 ， 进 而 显示 当前 视图 以 及 控制 器 返回 的 消息 值 。 
.yml 配置 文件 与 之 前 相同 ， 当 前 示例 针对 配置 文件 采用 了 .yml 格式 。 因 此 ， 该 文件 
等 同 于 REST 服务 所 用 的 文件 ， 唯 一 的 径 别 在 于 应 用 程序 名 称 和 服务 器 闹 口 。 上 共 体 如 下 : 


spring: 
application: 


name: spring-cloud-feign-client 


server: 
port: 8080 


eureka: 
client: 
service-url: 
default-zone: S(EUREKA URI:http://localhost:8761/eureka] 
instance: 


prefer-ip-address: true 


运行 该 应 用 程 厅 将 显示 Eureka Dashboard, ^ud 5.7 所 示 。 
DS Replicas 


Instances currently registered with Eureka 


Application N Availability Zones 
SPRING-CLOUD-EUREKA-CLIENT (1) 
SPRING-CLOUD-FEIGN-CLIENT (1) 


SPRING-CLOUD-RIBEON-CLIENT 


图 5.7 


图 5.7 中 显示 了 利用 Eureka 服务 器 注册 的 3 项 服务 ， 即 SPRING-CLOUD-EUREK A- 
CLIENT、SPRING-CLOUD-FEIGN-CLIENT 和 SPRING-CLOUD-RIBBON-CLIENT. 

E Exe strate, FAA Vi 282 Vj IH] http://localhost:8080/say-hello, XJ Z5 
如 图 5.8 所 示 。 
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ø Say Hello Page | Dinesh- x W 3 


vm Q | © 192.168.56.1:8080/say-hello 


Hello to the Dineshonjava from EurekaClient! 


图 5.8 
56 x 


本 章 讨 论 了 微服 务 架 构 及 其 优 喘 点 、 所 面临 的 挑战 任务 、 如 何 利 用 相关 Spring Cloud 
模块 处 理 此 类 问题 ， 如 Discovery Service 和 客户 端 负载 平衡 机 制 。 

男 外 ， 本 章 还 通过 Spring Netflix Eureka 服务 器 实现 了 一 个 服务 注册 中 心 ， 并 以 此 注 
册 某 些 Eureka 客户 端 。 同 时 ， 我 们 还 利用 EurekaClient 和 Feign Client 实现 了 多 个 客户 端 
应 用 程序 。Feign Client 通过 service-name 处 理 Discovery Service 问题 ， 且 在 默认 状态 下 
支持 负载 平衡 机 制 。 这 意味 着 ， 当 采用 Feign Client 访问 Eureka 注册 的 服务 时 ， 无须 显 式 
地 添加 Ribbon 进而 管理 多 个 服务 实例 间 的 加 载 问题 。 

通过 Feign Client 和 注册 中 心 ， 可 方便 地 定位 和 使 用 REST 服务 ， 即 使 对 应 位 置 友 生 
变化 。 

第 6 章 将 考查 并 实现 一 个 RESTful 微服 务 示例 。 
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本 章 将 竹 试 构建 一 个 RESTful 原子 做 服务 ， 并 通过 Spring Cloud 和 Spring Data 在 内 
存 数据 库 《〈 如 HSQL 或 H2) 上 执行 CRUD 操作 。 该 服务 针对 Eureka Server 的 服务 发 现 
注册 而 局 用 (参见 第 5 章 ) ， 并 通过 bootstrap.yml 和 application.yml 配置 该 服务 。 

第 5 章 讨论 了 微服 务 架 构 及 其 优点 和 所 面临 的 挑战 。 除 此 之 外 , 我 们 还 学 习 了 Eureka 
Server 和 Eureka Client， 并 利用 Eureka Server 注册 客户 站 。 在 本 章 中 ， 我 们 将 演 试 通过 
Spring Boot 和 在 Spring Cloud 创建 一 个 微服 务 示 例 。 

在 阅读 完 本 章 后 ， 读 者 将 能 够 较 好 地 理解 微服 务 以 及 简单 微服 务 的 构建 方式 。 本 章 
主要 涉及 以 下 主题 。 

D XT Spring Boot 的 做 服务 。 

口 ”简单 的 微服 务 示 例 : 

> Spring Data 简介 。 

>  bootstrap.yml 和 application.yml 简介 。 
口 ” 开 友人 简单 的 微服 务 示例 。 
Q ”创建 Discovery Server: 

> (@EnableEurekaServer. 
Q ”创建 微服 务 〈 生 产 者 ) : 


>  (QEnableEurekaChlent. 
>  (QEnableDiscoveryClient. 
>  (aRestController. 


Q ”创建 微服 务 使 用 者 。 
UU  (QSpringBootApplication 和 @SpringCloudApplication 。 
下 面 将 对 此 逐一 加 以 讨论 。 


6.1] 基于 Spring Boot 的 微服 务 
如 前 所 述 ， 币 服务 架构 可 将 大 型 系统 分 解 为 多 个 协作 组 件 。 对 此 ，Spring Framework 


提供 了 松散 看 合 的 组 件 〈 在 组 件 级 别 ) ;类 似 地 ， 基 于 Spring Boot 的 微服 务 也 提供 了 处 
理 级 别 上 的 、 松 散 耦合 的 组 件 。 
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这 里 ， 我 们 将 把 一 个 单 体 应 用 程序 分 解 为 多 个 较 小 的 微服 务 ， 并 在 有 界 上 下 文中 将 
每 项 服务 作为 单一 职 贡 进行 部 著 。 

当 采 用 Spring Boot 的 目 动 配置 时 ， 可 方便 地 创建 多 项 做 服务 。Spring Boot 提供 了 可 
添加 至 微服 务 应 用 程序 中 的 starter， 并 可 利用 内 舰 容 器 进行 部 署 。 

Spring Cloud 将 Spring Boot 扩展 全 原生 云 人 微服 务 领 域 ， 同 时 使 分 布 式微 服务 开发 更 
具 操 作 性 。 这 也 体现 了 Spring Boot 在 构建 微服 务 应 用 程序 时 的 真正 威力 。 此 外 ，Spring 
Boot 还 文 持 原生 云 应 用 程序 的 分 布 式 配置 。 

接 下 来 查看 Spring Boot 和 Spring Cloud 应 用 程序 中 不 同 配置 文件 的 应 用 位 置 。 


6.1.1 bootstrap.yml 和 application.yml f8j2T 


在 Spring Boot 应 用 程序 中 ， 对 应 的 配置 文件 为 application.properties 或 application.yml. 
其 中 ，application.yml 配置 文件 涵 关 了 与 应 用 程序 相关 的 配置 项 ， 如 服务 器 病 口 、JPA 配 
E PSU OE. 

对 于 Spring Cloud 应 用 程序 ， 多 个 微服 务 中 需要 使 用 到 采 些 设置 内 容 。 有 具体 来 说 ， 
Spring Cloud 应 用 程序 需要 使 用 到 以 下 两 种 类 型 的 配置 文件 : 

Q Bootstrap 应 用 程序 配置 文件 〈bootstrap.yml) 。 

Q ”应 用 程序 配置 文件 《application.yml) 。 

默认 状态 下 ，Bootstrap 属性 具有 较 高 的 添加 优先 级 ， 因 此 无 法 被 本 地 配置 所 履 兰 。 
bootstrap.yml (EX bootstrap.properties) 文件 将 在 application.yml (或 application.properties ) 
文件 之 前 被 加 载 。 另 外 ，Bootstrap 应 用 程序 配置 文件 类 似 于 application.yml 文件 ， 但 会 
在 应 用 程序 上 下 文 的 Bootstrap 除 段 被 加 载 。 

bootstrap.yml 文件 一 般 用 于 Spring Cloud Config Server 应 用 程序 中 。 正 如 第 4 章 所 做 
的 那 梓 ， 可 在 bootstrap.yml 文件 内 指定 spring.application.name 和 spring.cloud.config. 
Server.git.uri， 并 添加 某 些 加 蜜 /解密 信息 。 父 Spring ApplicaüonContext 〈 也 称 作 Bootstrap 
Application Context) 将 加 载 Bootstrap 应 用 程序 配置 文件 bootstrap.yml。 

Spring Cloud 应 用 程序 通常 从 Spring Cloud Config Server 中 加 载 配置 数据 。 因 此 ， 当 
加 载 URL 和 其 他 链接 配置 信息 时 ， 例 如 密码 和 加 密 / 解 密 人 信息， 首先 需要 使 用 到 相应 的 
Bootstrap 配置 内 容 。 针 对 于 此 ， 须 采用 文件 bootstrap.yml 来 置 入 用 于 加 载 实 际 配 置 数 据 


的 配置 项 。 
A Ml bootstrap.yml 文件 示例 : 
Spring: 


application: 
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name: foo 
cloud: 
config: 
Uti: SISPRING CONFIG URT.http-//loealhost:898B9] 

在 上 述 Bootstrap 配置 文件 中 ， 一般 包含 两 种 属性 ， 例 如 配置 服务 器 的 位 置 spring. 
cloud.config.uri， 以 及 应 用 程序 名 称 spring.application.name。 因 此 ， 在 Spring Cloud 应 用 
程序 局 动 阶段 ， 将 生成 一 个 HTTP 调用 并 从 Config Server 中 加 载 这 些 属 性 。 

当然 ， 也 可 完全 禁用 Bootstrap 处 理 过 程 ， 即 spring.cloud.bootstrap.enabled-false. 

接 下 来 考查 一 个 简单 的 微服 务 示 例 。 


6.1.2 f&] E BJ fro RR 25 zs 1 


KEKEE F Spring Boot 和 Spring Cloud 的 微服 务 示 例 。 在 第 5 章 中 ， 曾 
介绍 了 包含 3 个 微服 务 的 Bank 应 用 程序 示例 ， 即 AccountService、CustomerService 和 
Notification Service. 


图 6.1 TER T hb Up oS AUTE T DU P» 包 侣 上 述 3 个 模块 的 单 体 应 用 程序 的 示意 图 。 


Banking Application 


AccountService, CustomerService, NotificationService, .... 


图 6.1 


在 图 6.1 F, Banking Application 包含 了 3 个 模块 ， 分 别 是 AccountService s 
CustomerService 和 NotificationService。 其 中 ，AccountService 负责 管理 银行 系统 中 的 客 
户 数量 ， 例 如 开户 、 获 取 上 账户 细节 信息 、 升 级 账户 细节 信息 和 注销 账户 。 

FARSAH ETARE AccountService. CustomerService 和 NotificationService 
模块 分 解 为 多 个 独立 部 分 ， 且 彼此 间 各 上 自 进行 处 理 。 据 此 ， 可 单独 部 署 每 项 服务 ， 且 不 
会 妨 但 到 其 他 服务 。 这 里 ， 作 用 范围 更 加 微观 ， 也 就 是 说 ， 仪 关注 一 个 任务 单元 ， 而 不 
是 太 多 项 任务 。 根 据 微服 务 染 构 ， 图 6.2 显示 了 银行 系统 示意 图 。 
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|. Account . 
H2 DB 


«REB RHIPSAE 


图 6.2 


在 图 6.2 中 , 我 们 利用 微服 务 染 构 创 建 了 银行 系统 , 该 应 用 程序 被 划分 为 一 组 子 应 用 
程序 ， 即 微服 务 。 

接 下 来 讨论 如 何 通过 最 简单 的 子 系统 逐步 构建 大 型 系统 。 相 应 地 ， 当 前 仅 实 现 大 型 系 
统 的 一 小 部 分 内 容 ， 即 用 户 的 账户 系统 。 图 6.3 显示 了 当前 应 用 程序 化 中 的 众多 模块 之 一 。 


e 注册 服务 (Eureka) | 
a £L 查找 P ii g 注册 为 
account-service 7^ 


"^ account-service" 


RESTful 请 求 JPA/SQL 


07 y 
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针对 Banking 应 用 程序 中 的 某 个 模块 ， 下 面 开 始 创建 AccountService 微服 务 。Web 
应 用 程序 将 生成 请 求 ， 并 通过 RESTful API 访问 源 自 AccountService 中 的 数据 。 对 此 ， 需 
要 添加 一 项 发 现 服务 ， 以 便 其 他 处理 过 程 可 彼此 发 现 。 

最 后 ， 还 将 创建 一 个 账户 资源 ， 并 利用 相应 的 URI 和 HTTP 方法 公开 多 项 RESTful 
资源 ， 具 体 如 下 。 
检索 所 有 账户 :; @GetMapping("/account")。 
获取 额定 账户 的 细节 信息 : (QGetMapping(" /account/ (accountId? "). 
删除 某 个 账户 : @DeleteMapping("/account/ (accountId) "). 
创建 新 账户 : (qPostMapping("/account"). 
更 新 账户 细节 信息 : @PutMapping("account (accountId? "). 
可 以 看 到 ， 上 述 URI 针对 账户 微服 务 提 供 了 全 部 CRUD 操作 。 
1. 创建 发 现 服务 
下 面 开 始 创建 发 现 服务 。 如 前 所 述 ， 发 现 服务 可 处 理 原生 云 应 折 
”服务 间 如 何 彼 此 发 现 ? 
DD” 如果 同时 运行 条 项 服务 的 多 个 实例 ， 将 会 发 生 什么 情况 ? 
图 6.4 对 此 类 问题 进行 了 描述 (第 5 章 兽 对 此 有 上 所 分 析 ) 。 


LDLDLLL 


程序 中 的 以 下 问题 : 


利用 服务 发 现 获取 服务 针对 香 吐 量 和 弹性 
及 其 运行 实例 / 的 多 个 实例 


REST 请 求 E» m 


Web 应 用 程序 | 账户 服务 


JSON 


Account DB 
.. H2 DB 


图 6.4 
下 列 代码 显示 了 发 现 服务 所 需 的 Maven 依赖 关系 。 


«parent» 
«grouplId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starLter-parent«/artifactld» 
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«version»2.0.2.RELEASE«/version» 
«relativePath/» «!-- lookup parent from repository 一 一 > 
«/parent» 


«properties» 


«spring-cloud.version»Finchley.M8«/spring-cloud.version» 


«/properties» 


«dependencies» 
«dependency» 
«groupId»org.springframework.cloud«/groupId» 
«artifactlId»spring-cloud-starter-netflix-eurekaserverc/artifactld» 
</dependency> 
</dependencies> 


<dependencyManagement> 
«dependencies» 

«dependency» 
«groupld»org.springframework.cloudc/groupId» 
«artifactId»spring-cloud-dependencies«/artifactId» 
«version»$í(spring-cloud.version]«/version» 
«type»pomc/type» 

«scope»importc/scope» 
</dependency> 
</dependencies> 


</dependencyManagement> 

上 述 Maven 配置 项 与 Finchley.M8 fbi — HER E Spring Cloud 中 。 在 该 版 本 中 , 将 
EE Spring Cloud 所 项 的 所 有 传 违 依赖 项 。 

当前 ， spring-cloud-starter-eureka-server [fk 4 uiu 3T Maven 构造 配置 文件 中 

(pom.xml) 。 据 此 ， 应 用 程序 将 作为 Eureka Server 予以 启动。 不 难 发 现 ，spring-cloud- 
starter-eureka-server starter 视 为 Spring Cloud 项 目 中 的 一 部 分 内 容 ， 并 使 用 最 新 的 Spring 
Cloud 版 本 序列 (当前 为 Finchley.M8) 管理 其 他 云 依赖 天 系 的 Maven 依赖 项 版 本 。 

在 针对 Eureka Server NJN Y starter 依 顿 天 系 后 ， 还 需要 添加 一 个 Eureka Server 注册 
中 心 。 这 是 一 个 非常 简单 和 常规 的 Spring Boot 应 用 程序 ， 除 了 @SpringBootApplication 
之 外 还 需要 一 个 附加 注解 。 该 注解 被 添加 后 将 局 用 当前 服务 的 注册 中 心 。 因 此 ， 可 使 用 
Spring Cloud 的 @EnableEurekaServer 注解 创建 、 司 用 Eureka 注册 中 心服 务 器 。 当 前 应 用 
程序 可 与 这 一 注册 中 心 进 行 示 信 并 进行 目 身 注册 。 
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下 列 代 人 码 创建 了 一 个 友 现 注册 服务 ， 经 局 用 后 将 对 做 服务 进行 注册 。 


package com.dineshonjava.eurekaserver; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 


import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer; 


aSpringBootApplication 
aEnableEurekaServer 


public class EurekaServerApplication { 


public static void main(String[] args) 1 


SpringApplication.run(EurekaServerApplication.class, args); 


} 


上 述 代 码 定 义 了 一 个 较为 简单 的 Spring Boot 应 用 程序 类 ， 仅 通过 利用 
(QEnableEurekaServer 注解 入 口 点 类 即 可 方便 地 创建 Eureka Server。 该 类 仅 在 实现 注册 服 
务 时 加 以 使 用 。 

这 里 使 用 了 以 下 两 个 注解 : 

Q SpringBootApplication 。 

Qd (@EnableEurekaServer. 

其 中 ，@SpringBootApplication 注解 局 用 应 用 程序 并 加 载 与 Spring Cloud 相关 的 目 动 
配置 ; (QEnableEurekaServer 注解 局 用 后 将 当 醒 应 用 程 订 作为 Eureka Server 司 动 。 

在 application.properties 或 application.yml 文件 中 ， 针 对 服务 器 应 用 程序 ， 考 得 下 列 
基本 的 配置 项 。 


server: 
port: BIOL 

eureka: 
instance: 


hostname: localhost 
client: 
registerWithEureka: false 
fetchRegistry: false 
serviceUrl: 
defaultZone: 


http://Sí[eureka.instance.hostname]:S$í(server.port]/eureka/ 
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在 上 述 配置 中 ， 当 Eureka Server MHIE JIA IBI, A4 UT HRS aad 8761 上 的 注册 
操作 。 在 启动 时 ， 全 部 微服 务 将 利用 Eureka Server 进行 自身 注册 ， 即 调用 运行 于 服务 器 
ñm O 8761 上 的 Eureka Server 应 用 程序 。 其 他 服务 或 Web 应 用 程序 可 查询 Eureka Server, 
进而 可 发 现 其 他 注册 后 的 服务 。 访 问 http://localhost:8761， 将 显示 如 图 6.5 所 示 的 Eureka 
Dashboard. 


© spring Fure k g HOME LAST 1000 SINCE STARTUP 


System Status 
2018-03-1217 23:48:04 +0530 
00:00 


false 


1 


DS Replicas 


Instances currently registered with Eureka 


Application AMIS Availability Zones 


图 6.5 


在 几 6.5 中 可 以 看 到 ，Eureka Server 当前 处 于 平滑 的 运行 状态 ， 但 并 不 存在 Eureka 
注册 的 相关 实例 。 

在 创建 并 局 动 了 服务 注册 中 心 后 ， 下 面 开 始 创 建 一 个 客户 病 。 该 客户 疹 利 用 Eureka 
注册 服务 器 进行 自身 注册 , 并 使 用 Spring Cloud 的 DiscoveryClient 或 EurekaClient 5275 El 
身 的 注册 内 容 〈 通 过 主机 和 端口 ) 。 

2. 创建 微服 务 〈 生 产 者 ) 

下 面 尝 试 创建 一 个 微服 务 accountrservice， 访 微服 务 利用 注册 服务 或 者 上 友 现 服务 〈 包 
侣 逻辑 名 account-service) 对 其 目 身 进行 注册 。 

首先 需要 添加 所 需 的 Maven 依 顿 关 系 , 并 再次 使 用 spring-cloud 版 本 序列 对 版 本 进行 
管理 ， 如 下 所 示 : 

«properties» 


«spring-cloud.version»Finchley.M8«/spring-cloud.version» 


x/properties» 


«xdependencies-» 
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«dependency» 
«groupId»org.springframework.boot«/groupId» 
XartifactlId»spring-boot-starter-data-jpac/artifactld» 
</dependency> 
<dependency> 
«groupld»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 
</dependency> 
<dependency> 
«groupId»org.springframework.cloudc/groupId» 
«artifactlId»spring-cloud-starter-netflix-eurekaclient«/artifactId» 
</dependency> 
<dependency> 
«groupId»com.h2databasec/groupIlId» 
<xartifactId>h2</artifactId> 
<scope>runtime</scope> 
</dependency> 
</dependencies> 


<dependencyManagement> 
<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-dependencies</artifactId> 
«version»$í(spring-cloud.version]«/version» 
«type»pom«/type» 
«scope»importc«/scope» 
</dependency> 
</dependencies> 


</dependencyManagement> 


上 述 Maven 配置 针对 @EnableEurkaClient〈 而 非 @EnableDiscoveryClient 注解 ) 包含 了 
spring-cloud-starter-netflix-eurekaclient 依赖 项 。 为 外 ， 还 可 使 用 注解 @EnableDiscoveryClient 
并 迪 过 注册 服务 各 注册 设 项 服务 。 同 时 ， 设 配 站 还 分 别 包 含 spring-bootstarter-data-jpa 
dependency 依赖 项 (创建 Spring Data JPA 存储 库 ) ~ springboot-starter-web (创建 
@RestController) 以 及 h2 内 存 存 储 库 ， 进 而 保存 与 账户 应 用 程序 相关 联 的 数据 。 

下 列 代 人 三 显示 了 Spring Boot 应 用 程序 accountservice 的 main Z5. 


package com.dineshonjava.accountservice; 


import org.springframework.boot.SpringApplication; 


import org.springframework.boot.autoconfigure.SpringBootApplication; 
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import org.springframework.cloud.netflix.eureka.EnableEurekaClient; 


aSpringBootApplication 
aEnableEurekaClient 


public class AccountServiceApplication { 


public static void maijrn(5tring[] args) 1 
SpringApplication.run(AccountServiceApplication.class, args); 
} 
} 


上 述 main 应 用 程序 类 采用 @SpringBootApplication £I (g)EnableEurekaClient 进行 注解 。 
其 中 ，@SpringBootApplication 用 于 Spring Boot 目 动 配置 〈 之 前 已 对 此 有 所 介绍 ) ; 
@EnableEurekaClient 则 用 于 激活 Netflix EurekaClient 实现 。 

3j 57h. xe np] Hi (Configuration 类 上 的 @EnableDiscoveryClient x fE, Bk 
(QSpringBootApplication 入 口 点 美 司 用 发 现 服务 。 相 应 地 ，Q@EnableDiscoveryClient 1$3X 
活 Netflix Eureka DiscoveryClient 实现 。 

Discovery Service 存在 多 种 实现 ， 如 Eureka. Consul 和 Zookeeper。 当 前 示例 显 式 地 
4E HJ f Q)EnableEurekaClient, HAX spring-cloud-starter-netflix-eureka-client WATTE M 
用 程序 类 路 径 上 有 效 时 ，@EnableEurekaClient 方 为 有 效 ， 且 仅 适 用 于 Eureka. Ah, Xf 
可 使 用 @EnableDiscoveryClient， 它 位 于 spring-cloud-commons 中 ， 并 选择 类 路 径 上 的 实 
现 。 实 际 上 ， 注 解 @EnableEurekaClient 和 @EnableDiscoveryClient 之 间 并 无 差别 ， 二 者 保 
持 一 致 。 

下 面 利 用 一 组 配置 项 创建 配置 文件 application.properties (8% application.yml) ， 如 下 
Fr: 

mn 

application: 


name: account-service 


server: 
port: 6060 


eureka: 
client: 
ervice-url: 
default-zone: S$S(EUREKA URI:http://localhost:8761/eureka] 
instance: 


prefer-ip-address: true 
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其 中 ,应 用 程序 名 为 account-service, H.H 25-8 9m O 73y 6060。 这 将 通知 应 用 程序 Eureka 
Server 在 哪里 使 用 account-service 逻辑 服务 名 称 注 册 自 己 。 
接 下 来 启用 account-service， 并 利用 Eureka 发 现 服务 进行 注册 ， 如 图 6.6 所 示 。 


© spring Fureka HOME LAST1000 SINCE STARTUP 


System Status 


Environment test Current time 2018-03-13T12:35:06 «0530 
Data center default Upcrme 00:02 
Lease expiration enabled false 


Renews threshold 3 


Renews (last min) o 
DS Replicas 

Instances currently registered with Eureka 

Application AAMs Availability Zones 

ACCOUNT-SERVICE n/aí(1) (1) 

General Info 


Name Value 


total-avail-memoaorny 344mb 


environment test 


图 6.6 


在 图 6.6 H, ACCOUNT-SERVICE 利用 Eureka 发 现 服务 进行 注册 (位 于 Instances 
currently registered with Eureka 下 方 ) 。 

3833 H EFI, (QEnableEurekaClient 注解 将 应 用 程序 account-service 置 入 Eureka 9C 
TAURI—A EP mP CER 6.6 中 可 以 看 到 这 一 点 ) ， 以 便 访 问 或 得 询 其 他 注册 后 的 服务 。 
相应 地 , 我 们 可 控制 此 类 实例 的 行为 , 同时 还 可 查看 其 健康 状态 , 即 利用 eureka.instance.* 
Fio ELBERIO BLA ES v BLU 

接 下 来 全 看 当 醒 服务 的 其 他 类 。 之 前 置 利 用 @RestController 注解 创建 了 一 个 REST 
Tm. XX HURPDEHHVAVENTFGUEE REST 控制 各 以 处 理 RESTful API 调用 ， 如 下 所 示 : 

package com.dineshonjava.accountservice.controller; 

»NDOFE Java- tl: List; 

import org.springframework.beans.factory.annotation.Autowired; 

import org.springframework.web.bind.annotation.DeleteMapping; 

import org.springframework.web.bind.annotation.GetMapping; 

import org.springframework.web.bind.annotation.PathVariable; 


import org.springframework.web.bind.annotation.PostMapping; 
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import org.springframework.web.bind.annotation.PutMapping; 


import org.springframework.web.bind.annotation.RequestBody; 


import org.springframework.web.bind.annotation.RestController; 


import com.dineshonjava.accountservice.domain.Account; 


import com.dineshonjava.accountservice.repository.AccountRepository; 


aRestController 
public class AccountConbtroller 1 

QAutowired 

AccountRepository accountRepository; 

QGPostMapping (value = "/account") 

public Account save (G8RequestBody Account account) { 
return accountRepository.save (account); 

} 

@GetMapping (value = "/account") 

public Iterable<Account> all (){ 
return accountRepository.findAll (); 

} 

@GetMapping (value = "/account/[accountId]") 

public Account findByAccountId (GPathVariable Integer accountId){ 
return accountRepository.findAccountByAccountIid (accountId) ; 

} 

@PutMapping (value = "/account") 

public Account update (@RequestBody Account account) { 
return accountRepository.save (account); 

} 

@DeleteMapping (value = "/account") 

public void delete (GRequestBody Account account) { 


accountRepository.delete (account); 


} 


REST 控制 器 包含 了 多 个 请 求 处 理 方法 以 执行 CRUD 操作 。 其 中 ，saveO 请 求 处 理 方 
法 将 创建 一 个 新 账户 ; all0 方 法 则 可 读 取 全 部 账户 ; updateO 处 理 方法 用 于 更 新 已 有 的 账 
户 〈 包 含 既 定 的 账户 ID，〉; 另外 ，delete0 处 理 方 法 将 删除 一 个 账户 。 

AccountController REST 控制 占 包 含 了 一 个 AccountRepository 属性 , iz rfe HR 
Spring Data JPA 的 CrudRepository 接口 扩展 得 到 的 接口 。 稍 后 将 对 Spring Data 加 以 介绍 。 
另外 ， 该 存储 库 使 用 H2 数据 库存 储 与 账户 相关 的 所 有 信息 。 关 于 账户 服务 应 用 程序 ， 读 
者 可 访问 GitHub 获取 完整 示例 。 
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FHAA FJ URI 是否 被 账户 微服 务 的 REST 控制 器 所 公开 。 

创建 新 的 账户 : @PostMapping("/account")。 

谈 取 所 有 账户 : @GetMapping("/account"). 

获取 特定 账户 的 细节 信息 : @GetMapping("/account (accountId? "). 
更 新 账户 细节 信息 : qPutMapping("/account/ (accountId) "). 
删除 账户 : (QDeleteMapping(" /account"). 

Ee? jf Web 应 用 程序 加 以 使 用 ， 进 而 访问 账户 微服 务 。 

下 面 和 尝试 创建 微服 务 使 用 者 。 

3. 创建 微服 务 使 用 者 


当 使 用 RESTful 微服 务 时 ， 首 先 需 要 创建 一 个 使 用 者 Web 应 用 程序 ， 访 应 用 程序 将 
使 用 到 RESTful lE AS 9m si. Spring 提供 了 多 种 方式 使 用 微服 务 ， 但 在 Web 应 用 程序 中 ， 
我 们 将 使 用 RestTemplate 2$. RestTemplate 类 可 问 RESTful 服务 器 发 送 HTTP 请 求 ， 并 
以 多 种 格式 获取 数据 ， 如 JSON 和 XML。 

数据 格式 取决 于 Web 应 用 程序 类 路 径 中 是 否 存在 编组 (marshalling) 类 。 如 果 类 路 
径 中 包 侣 了 Jackson JARS， 那 么 Web 应 用 程序 将 文 持 JSON 格式 。 类 似 地 ， 如 果 JAXB 
JARS 出 现 于 类 路 径 中 ，Web 应 用 程序 还 将 支持 XML 格式 。 

在 Web 应 用 程序 中 ，WEB-APPLICATION 组 件 取 决 于 后 端 微服 务 (ACCOUNT- 
SERVICE) 。 通 过 采用 逻辑 服务 名 《而 不 是 对 微服 务 的 位 置 进行 硬 编码 ) ， 该 应 用 程序 
将 与 账户 微服 务 进行 通信 ;该 Web 应 用 程序 将 请 求 Eureka 解析 微服 务 的 主机 和 端口 。 

AAI Web 应 用 程序 的 main 程序 ， 如 下 所 示 : 


package com.dineshonjava.webapplication; 
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import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.cloud.client.loadbalancer.LoadBalanced; 
import org.springframework.cloud.netflix.eureka.EnableEurekaClient; 
import org.springframework.context.annotation.Bean; 


import org.springframework.web.client.RestTemplate; 


aSpringBootApplication 
aEnableEurekaClient 
public class WebApplication { 


public statıc void marn(String[]l args) 1 


SpringApplication.run(WebApplication.class, args); 
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RIDE 

QBean 

RestTemplate restTemplate() 1 
return new RestTemplate(); 

} 

} 

该 类 包含 了 @EnableEurekaClient I}, Jf RJFHEBR AS SCHALE JANER. mE, HE 
处 还 通过 @LoadBalanced 注解 配置 了 一 个 Bean (RestTemplate) ， 这 意味 看 ，Web MH 
程序 包含 了 负载 平衡 的 RestTemplate。 

(1) 负载 平衡 的 RestTemplate 

RestTemplate Bean 将 被 Spring Cloud RR ŻA JMA CST @LoadBalanced 注释 ) , 
以 使 用 目 定 义 的 HttpRequestClient (使 用 Netflix Ribbon 进行 微服 务 查 找 ) 。 这 里 , Ribbon 
也 是 一 个 负载 平衡 器 (Eureka 或 Consul 目 身 均 不 执行 负载 平衡 ， 因 而 这 里 采用 Ribbon 
予以 实现 ) 。 


O 注意 : 
É Brixton Release Train ( Spring Cloud 1.1.0.RELEASE ) 开始 ，RestTemplate 将 不 再 
被 自动 创建 。 在 之 前 的 版 本 中 ， 这 往往 会 造成 混 消 和 潜在 的 冲突 。 


loadBalancer 使 用 好 辑 服务 名 (利用 发 现 服务 右 进 行 注 册 〉 ， 并 将 其 转换 为 所 选 微服 
务 的 实际 主机 名 。RestTemplate 实例 是 线程 安全 的 , 并 可 在 应 用 程序 的 不 同 部 分 中 访问 任 
AAEH e 

下 面 查 看 Web 应 用 程序 的 配置 文件 ， 如 下 所 示 : 


apr ing: 
application: 


name: web-application 


server: 
port: 6464 


eureka: 
client: 
service-url: 
default-zone: S$(EUREKA URI:http://localhost:87061/eureka] 
instance: 
prefer-ip-address: true 
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在 配置 文件 创建 完毕 后 ， 接 下 来 运行 main 应 用 程序 类 ， 对 应 结果 如 图 6.7 所 示 。 


© spring Fureka HOME LAST 1000 SINCE STARTUP 


System Status 
Environrnent test Current time 2018-03-13T17:54-Q00 +0530 
Data center default Uptime 00:03 

Lease expiration enabled false 

Renews threshold 5 


Renews (last min) 0 
DS Replicas 


Instances currently registered with Eureka 


Application Availability Zones 
ACCOUNT-SERVICE 


WEB-APPLICA TION 


图 6.7 


其 中 , WEB-APPLICATION 利用 Eureka 发 现 服务 进行 注册 。 下 面 查看 WebAccountService 
类 ， 该 类 通过 名 称 ( 而 非 服务 器 地 址 ) 访问 账户 微服 务 ， 如 下 所 示 : 


package com.dineshonjava.webapplication.service; 


import java.util.List; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.cloud.client.loadbalancer.LoadBalanceqg; 
import org.springframework.stereotype.Service; 


import org.springframework.web.client.RestTemplate; 


import com.dineshonjava.webapplication.domain.Account; 


import com.dineshonjava.webapplication.exception.AccountNotFoundException; 


aService 
public class WebAccountsService { 
aAutowired 
protected RestTemplate restTemplate; 
// ACCOUNTS-SERVICE is the name of the microservice we're calling 
protected String serviceUrl -~ "http://ACCOUNT-SERVICE"; 
public Account getByNumber(String accountNumber) { 


Account account - restTemplate.getForObject (serviceUrl 
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4 "laccount/[accountlid|", Account.class; accountNumber) ; 
1f (account == niti) 
throw new AccountNotFoundException(accountNumber); 
else 
return account; 
} 
public List«Account» getAllAccounts f()í 
return restTemplate.getForObject (serviceUrl* "/account", 
List.class); 


j 


} 


service 类 针对 当前 Web M HIEST Ui i Ja? uUi KH @LoadBalanced 注解 的 
RestTemplate 通过 查询 Eureka 将 应 用 程序 名 (ACCOUNT-SERVICE ) 解析 为 实际 的 服务 
w Mim. Tt/FaLoadBalanced 通知 Spring Boot 使 用 ClientHttpRequestFactory HE X. 
RestTemplate, 该 工厂 在 进行 HITP 调用 之 前 执行 查找 。 对 此 , m 3 [n] application.properties 
中 添加 新 的 配置 设置 项 ， 如 下 所 示 : 


ribbon.http.client.enabled-true 


读者 可 访问 GitHub 获取 完整 的 Web 应 用 程序 ， 对 应 网 址 为 https://github.com/ 
PacktPublishing/Mastering-Spring-Boot-2.0. 
接 下 来 讨论 Spring Framework 的 Spring Data Ji H « 


6.2. Spring Data 简介 


Spring Data 十 Spring Source H H If] AE fs, Ev VE HAE £6 — I fa] ASTA [8] 278 23 8 
存储 的 访问 ， 如 关系 数据 库 和 NoSQL 数据 存储 。Spring Data 自在 提供 一 个 一 致 、 可 靠 的 
平台 ， 并 在 保证 数据 存储 特性 不 变 的 情况 下 访问 数据 。Spring Data 模型 基于 Spring 编程 。 

Spring Data 提供 了 易于 使 用 的 存储 技术 ， 其 中 包括 以 下 方面 : 

口 ” 关 系 型 数据 库 。 

口 ” 非 关系 型 数据 库 。 

Q  Map-Reduce 框架 。 

D ”基于 云 的 数据 服务 。 

Spring Data 项 目 类 似 于 一 些 大 型 项 目 ， 其 中 涵盖 了 许多 特定 于 所 需 技术 的 子 项 目 。 
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Spring Data 包含 了 诸多 特性 ， 下 面 仅 列 出 其 中 的 几 项 内 容 : 
强大 的 存储 库 。 
自 定 义 的 对 象 -映射 抽象 机 制 |。 
A FME EA RRI E H ENF o 
AETXIAHJZS, HET a pe HERH SE . 
SCRNORB RR VE. PUCER AREMA. 
可 将 目 定 义 的 存储 库 代 码 整 合 至 项 目 中 。 
通过 自 定 义 的 XML 命名 空间 或 JavaConfig, 可 实现 更 加 方便 的 Spring 集成 操作 。 
利用 Spring MVC 模块 ， 可 实现 高 级 的 集成 操作 。 

"AE Spring Data 项 目下 的 不 同 的 独立 项 目 时 ， 利 用 针对 所 有 项 目的 依赖 项 集合 ， 
可 发 布 一 个 数据 清单 。 其 中 ， 版 本 序列 按 名 称 分 类 ， 而 非 版 本 。Spring Data 的 核心 目标 
是 提供 一 个 大 众 型 的 、 可 靠 的 、 基 于 Spring 的 编码 模型 ， 以 隐藏 某 些 细节 内 容 。 

在 获取 创新 、 数 据 库 、 框 架 结构 和 云 服务 方面 ，Spring Data 使 得 数据 获取 的 方式 更 
加 简单 。Spring Data PiE J WLT RH, HE ETEA EAE. EKTA- E 
WIERHEIT, RIAA A LEII IG ACE T ER PEH 


6.2.1 Apache Ignite 存储 库 


LLLL LLL 


L 


Spring Data Framework ji ft f 3E 45378 HN FII 17 8] API, 同时 支持 源 目 应 用 程序 层 的 
抽象 基础 信息 存储 。Spring Data 使 得 用 户 不 必 局 限于 某 家 特定 的 数据 库 厂商 ， 并 可 在 不 
同 的 数据 库 间 实现 快速 调整 。 

Apache Ignite 实现 了 Spring Data CrudRepository 接口 , 进而 支持 基本 的 CRUD 操作 ， 
FANEN ARERI Spring Data API 访问 Apache Ignite SQL Grid. 


6.2.2 Spring Data MongoDB 


Spring Data MongoDB 是 Spring Data 中 的 一 部 分 内 容 ， 旨 在 为 新 的 数据 存储 提供 一 
个 目 然 的 、 稳 定 的 基于 Spring 的 编程 模型 ， 同 时 保留 存储 的 茶 些 亮点 和 功能 。 

Spring Data MongoDB 提供 了 协调 MongoDB 报告 数据 库 的 功能 。Spring Data 
MongoDB 的 核心 应 用 领域 是 一 个 POJO 驱动 模型 ,用 于 连接 MongoDB DBCollection, 并 
可 轻松 地 将 存储 库 信 息 整 合 至 层 中 。 

下 面 列 举 了 Spring MongoDB 的 一 些 优 点 : 

D Spring setup bolster 使 用 基于 Java 的 @Configuration 类 或 XML 命名 空间 来 处 理 
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Mongo 驱动 程序 场景 和 模拟 集 。 


Q 可 局 效 地 构建 mongo 模板 辅助 类 ， 并 执行 正常 的 Mongo 操作 。 
口 ” 在 记录 和 了 POJO 则 引入 了 协调 对 抗 Cprotest) 映射 。 
UD” 将 特例 解释 为 Spring 的 Data Access Exception 链 。 
L] 与 Spring Conversion Service 相配 合 的 Highlight Rich Object Mapping. 
D FRERE MRA HRAD ETE, ET K UEM. 
D FETETELE 178 8]. 
Q XH MongoReader/MongoWriter 反射 的 底层 映射 机 制 。 
Q 基于 Java] Query. Criteria 和 Update DSL. 
”存储 库 接口 的 编程 应 用 ， 包 括 对 自 定义 发 现 策 略 的 支持 。 
口 QueryDSL 协调 以 实现 安全 的 得 询 。 
D ”路 存储 持久 性 且 文 持 卫 A 实 体 ( 基 于 使 用 MongoDB 可 下 接 持 久 化 /恢复 的 字段 )。 
d  Log4j 日 志 输 出 程序 。 
Qd  GeoSpatial. 
JW Guide Reduce. 
Qd JMX 组 织 和 检查 。 
Qd CDI bolster. 
Wd GridFS. 
6.2.3 Spring Data JPA 


Spring Data JPA 是 较 大 的 Spring Data 分 组 中 的 一 部 分 内 容 ， 可 简化 执行 基于 JPA 的 
存储 库 。 该 模块 针对 基于 JPA 的 信息 管理 一 个 更 新 后 的 bolster 进而 获取 相关 层 。Spring 
Data JPA 可 催化 通过 信息 获得 改观 的 、Spring 应 用 程序 的 创建 过 程 。 


63 JA x^ 


本 章 创建 了 一 个 名 为 ACCOUNT-SERVICE 的 微服 务 ， 并 利用 Eureka 发 现 服务 注册 
该 项 服务 。 此 外 ， 我 们 还 通过 Web 应 用 程序 创建 了 微服 务 的 使 用 者 ， 同 时 利用 Eureka 
发 现 服 务实 现 自身 的 注册 ， 进 而 使 用 accountservice， 即 采用 其 逻辑 名 ， 而 不 是 对 主机 名 
和 服务 器 病 口 进行 便 编 公 。 

Netflix Eureka 以 服务 发 现 和 客户 问 的 方式 工作 , Spring Cloud 对 此 予以 支持 并 针对 原 
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生 云 问题 提供 了 相应 的 解决 方案 。 

Netflix Ribbon 利用 Spring 中 的 RestTemplate 实现 了 客户 端的 复杂 平衡 机 制 。Spring 
Cloud 文 持 服务 注册 和 客户 闯 的 负载 平衡 机 制 ， 从 而 构建 更 加 可 靠 的 系统 。 

此 外 ， 本 章 还 讨论 了 与 Spring Data 项 目 相 关 的 一 些 内 容 。 例 如 ，Spring 如 何 通过 接 
口 创建 存储 库 。 相 应 地 ， 我 们 创建 了 一 个 存储 库 并 通过 H2 数据 库 构 建 了 CRUD 操作 。 

第 7 章 将 讨论 并 实现 一 个 异步 啊 应 系统 。 
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在 第 6 章 中 ， 我 们 创建 了 微服 务 并 利用 Eureka 注册 服务 进行 和 注册。 本 章 将 讨论 针对 
微服 务 通信 的 API 网 关 模 式 ， 且 分 别 源 目 UI 组 件 或 内 部 服务 调用 。 同 时 ， 还 将 利用 
Netflix Zuul API 实现 API 网 关 ， 并 探讨 如 何在 应 用 程序 中 设置 Zuul Proxy. 

Spring Cloud x $$ Netflix Zuul 以 实现 针对 实际 微服 务 请 求 的 路 由 和 过 渡 机 制 。 在 阅 
读 完 本 章 内 容 后 ， 读 者 将 能 够 较 好 地 理解 API 网 天 和 Zuul 代理 。 

本 章 主 要 涉及 以 下 内 容 : 

Q API 网 关 模式 需求 。 


口 API 网 关 模 式 组 件 。 

口 ”利用 Netflix Zuul 实现 API 网 关 。 
OD ”利用 Maven 依赖 关系 包含 Zuul. 
2 ”局 用 Zul 服务 代理 。 

DD” 配置 Zuul 属性 。 

n 


VH Zuul 过 滤器 。 
7.1 API 网 关 模 式 需 求 


在 微服 务 架 构 中 ， 存 在 大 量 的 API 服务 可 用 于 分 布 式 应 用 程序 中 ， 大 约 有 超过 100 
个 API 和 UI 组 件 可 针对 菏 个 业务 目标 实现 役 此 间 的 通信 。 因 此 ， 此 类 UI 组 件 需要 连接 
所 有 包含 端口 的 微服 务 问 点 ， 并 在 未 使 用 API 网 关 时 调用 此 类 API 服务 。 

API 网 关机 制 在 实现 分 布 式 应 用 程序 公共 部 分 时 将 发 挥 其 功效 , 如 CORS、 验证 机 制 、 
安全 性 以 及 检测 机 制 。 人 否则 ， 需 要 将 其 实现 于 所 有 的 API 服务 中 。 相 应 地 ， 相 同 的 代码 
将 在 所 有 微服 务 间 重复 使 用 。 为 了 避免 这 一 问题 ， 需 要 使 用 公共 服务 或 入 口 点 ， 并 于 其 
中 编写 全 部 公共 代码 ， 客 户 问 将 调用 这 一 类 公共 服务 。 

图 7.1 显示 了 未 使 用 API 网 关 时 分 布 式 应 用 程序 的 示意 图 。 

可 以 看 到 ， 每 个 UI 组 件 必 须知 道 使 用 Eureka 服务 占 的 每 个 服务 羡 点 。Customer- 
Service 的 UI 组 件 需要 包 侣 与 Customer 微服 务 问 点 (利用 Eureka Server 进行 注册 ) 相关 
的 信息 。 类 似 地 ， 账 户 的 可 组 件 也 需要 知道 Account 微服 务 的 端点 。 某 些 时 候 ， 维 护 、 
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向 外 部 公开 此 类 端点 ， 并 希望 保持 API 服务 的 私有 性 。 针 对 于 此 ， 可 提供 API 网 关 ， 并 
将 全 部 API 调用 委托 至 后 台中 的 各 个 微服 务 中 。 


Account UI Customer Ul 
Fureka Registry 


"a 


Account-Service Customer-Service 


未 采用 API 网 关 代 理 的 微服 务 


图 7.1 


API 网 关 是 一 类 统一 的 代理 接口 ， 并 将 调用 委托 至 URL. 模式 上 的 多 个 微服 务 。 本 章 
将 通过 Spring Cloud 的 Zuul Proxy 实现 此 类 API 网 关 代 理 。 其 中 ，API 网 关 接 口 可 问 外 
部 客户 端 公开 一 组 公共 服务 ， 且 不 会 违背 任何 安全 规定 。 图 7.2 显示 了 AP 网 关 接 口 ， 


进而 调用 API 服务 。 


API 网 关上 服务 (Zuul) 


Eureka Registry 


基于 API 网 关 代理 的 微服 务 架 构 


图 了 2 


在 图 7.2 中 ，UI 组 件 通过 API Gateway 调用 API 服务 。 当 前 ， 每 个 UI 组 件 无 顷 了 解 
各 项 微服 务 的 实际 端点 。 此 处 公开 了 一 项 服务 ， 即 API Gateway 服务 ， 其 中 包含 了 针对 
所 有 UI 组 件 的 主机 和 关口 。 该 API Gateway 服务 也 称 作 边缘 服务 一 一 该 服务 位 于 分 布 式 
应 用 程序 中 其 他 微服 务 之 上 。 针 对 全 部 内 部 微服 务 ， 客 户 端 将 作为 代理 调用 该 边缘 服务 。 
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接 下 来 将 探讨 API Gateway 代理 服务 的 优 、 缺 点 。 在 微服 务 应 用 程序 中 使 用 API 
Gateway 涉及 多 种 原因 ， 稍 后 将 对 此 加 以 分 析 。 


quM 


API Gateway 模式 的 优点 


在 分 布 式 应 用 程序 中 ，API Gateway 代理 的 优点 主要 包括 以 下 方面 : 


图 
E 


LLLL 


XT RP wu. API Gateway 简化 了 API 服务 的 调用 。 

用 户 可 在 单一 位 置 〈 而 不 是 路 多 项 服务 ) 采用 特定 客户 端的 策略 ， 例 如 身份 验 
证 和 速率 限制 。 

利用 公开 的 内 部 微服 务 端点 向 客户 端 展 示 所 选 的 API。 

微服 务 端点 可 以 在 不 强制 客户 端 重 构 应 用 逻辑 的 情况 下 进行 更 改 。 

可 实现 任意 路 由 规则 或 过 滤器 实现 。 

API 网 关 束 像 是 一 个 边缘 微服 务 ， 同 时 也 是 独立 可 伸缩 的 。 


上 述 各 项 内 容 人 简单 地 介绍 了 微服 务 架 构 中 API Gateway 代理 服务 的 一 些 优点 ， 下 面 
再 来 看 看 该 模式 中 的 一 些 缺点 。 


L2 


API Gateway 的 一 些 缺 点 


在 分 布 式 应 用 程序 中 ，API Gateway 代理 的 一 些 缺 点 包括 以 下 方面 : 
Q API Gateway 是 一 个 独立 的 入 口 点 ， 并 应 用 于 所 有 公共 部 分 ， 茶 些 时 候 ， 如 末 不 


E 


采取 适当 的 措施 使 其 具有 高 可 用 性 ， 单 点 故障 可 能 处 于 危险 境地 。 
在 API Gateway 服务 中 ， 管 理 不 同 微服 务 的 API 信息 较为 困难 。 


随后 ， 我 们 将 讨论 API Gateway 模式 组 件 。 


7.1.3 API Gateway 模式 组 件 


API Gateway 模式 基于 代理 API 服务 调用 。API Gateway 代理 模式 主要 包含 了 4 种 类 
型 的 过 滤器 ， 此 类 过 滤器 将 拦截 来 自 客 户 端 应 用 程序 的 HTTP 请 求 。 除 此 之 外 ， 还 可 针 
对 特定 的 URL 模式 添加 自 定义 过 滤器 。 图 7.3 显示 了 API Gateway 中 的 组 件 。 

如 前 所 述 ，API Gateway 主要 包 合 以 下 4 PILIERS o 


E 
n" 
- 


前 置 过 滤器 : 此 类 过 小 器 在 HTTP 请 求 被 路 由 之 前 被 调用 。 
Ja ED JESSR: ERLIE HTTP 请 求 路 由 之 后 被 调 用 。 
PETEA: 此 类 过 小 乾 用 于 路 由 HTTP 请 求 。 
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各 户 痛 应 用 程序 〈UI 组件) 


1. HTTP 请 求 N 5. HTTP 响应 


2， 解析 请 求 API 网 关 代 理 服务 


] 前 置 过 滤器 | 路 由 过 滤器 后 置 过 滤器 
Cum 


Account Microservice | Customer Microservice 


图 7.3 


D RIES: 当 处 理 HTTP incKOIXdECBICAETREYAHN. f4 H ERNEA o 

在 图 7.3 F, 28 P 9 WE FH REI IR] API Gateway 服务 发 送 HTTP 请 求 ， 前 置 过 滤器 将 拦 
截 来 自 客 户 靖 应 用 程序 的 HTTP 请 求 ， 并 将 其 转发 至 路 由 过 滤器 ， 进 而 将 此 类 请 求 路 由 
至 内 部 各 微服 务 处 ， 如 账户 微服 务 、 使 用 者 微服 务 。 相 应 地 ， 微 服务 将 相应 发 送 至 后 置 
过 滤器 中 。 最 终 ， 后 置 过 滤器 将 HTTP 响应 转发 至 客户 端 应 用 程序 中 。 

前 述 内 容 介 绍 了 微服 务 架 构 中 的 API Gateway。 下 面 尝试 利用 Spring Cloud 的 Netflix 
Zuul API 在 微服 务 应 用 程序 中 实现 该 模式 。 


7.2 ”利用 Netflix Zuul Proxy 实现 API Gateway 


本 而 将 针对 微服 务 应 用 程序 实现 路 由 机 制 。 前 述 内 容 曾 讨论 了 针对 API 服务 的 路 由 
机 制 的 重要 性 ， 这 里 将 对 此 创建 两 个 微服 务 ， 即 Account 和 Customer。 男 外 ，Eureka 注 
册 应 用 程序 也 已 编 写 完 毕 。 例 如 ，/apiaccounts 映射 至 Account 服务 ，/api/customers 映射 
至 Customer 服务 。 

当前 示例 将 使 用 Netflix 的 Zuul API 实现 API Gateway 代理 , 进而 对 API 调用 进行 路 
Ho Spring 5 Netflix Zuul KAZE, [RJ pk f Spring Cloud Netflix Zuul 模块 。 其 中 ， 
Zuul 表示 为 一 个 基于 Java RAA 039 UH TERRAS ds? HAE T. Netflix B) 8 2 ^P f d 

通过 Zuul 代理 ， 这 里 将 调用 Account 和 Customer， 并 可 用 于 创建 API 网 关 。 除 此 之 
外 ， 还 需要 针对 API Gateway 边缘 服务 创建 另 一 个 微服 务 。 

FEAH Spring Initializr 的 Web 务 面 〈 对 应 网 址 为 http:/start.spring.io/) 创建 一 个 
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Spring Boot 项 目 ， 对 应 的 应 用 程序 名 为 Api-Zuul-Service， 同 时 选取 Zuul 和 Eureka 
Discovery 模块 。 对 应 的 Edge Service 为 Eureka 7x? im H 5 . 
随后 ， 可 在 微服 务 应 用 程序 中 包含 Spring Cloud 的 Netflix Zuul Fe. 


7.2.1 利用 Maven 依赖 关系 包含 Zuu| 


Hc. nu XP Spring Cloud 对 Zuul 所 文 持 的 依赖 项 洪 加 全 UI 应 用 程序 的 pom.xml 
文件 中 ， 如 下 所 未: 


«dependencies» 


«dependency» 

«grouplId»org.springframework.cloud«/groupId» 
«artifactlId»spring-cloud-starter-netflix-eureka-client«/artifactlId» 
</dependency> 

<dependency> 

<groupId>org.springframework .cloud</groupId> 
«artifactlId»5spring-cloud-starter-netflix-zuul«/artifactId» 
«/dependency» 

«dependency» 

«groupld»org.springframework.bootc«/groupId» 
«artifactId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 

</dependency> 


</dependencies> 


Œ Ei Maven 配置 文件 中 ， 我 们 利用 spring-cloud-starter-netflix-zuul 和 
org.springframework.cloud 添加 了 Zuul 库 。 另 外 ， 还 加 入 了 spring-cloud-starter-netflix- 
eureka-client 依赖 项 ， 并 通过 Eureka 注册 服务 器 注册 api-gateway-service. 

SJE, Zuul Maven 依赖 关系 已 被 添加 至 Spring Boot 应 用 程序 中 。 但 默认 状态 下 ， 
Zuul 处 于 禁用 状态 ， 因 此 需要 局 用 Zuul 代理 服务 。 


7.22 ”启用 Zuul 服务 代理 


相应 地 ， 可 在 ApiZuulServiceApplication Spring Boot 类 之 前 次 加 @EnableZuulProxy 
注解 , 该 注解 将 局 用 应 用 程序 中 的 Zuul 服务 代理 ,同时 局 用 API Gateway 层 的 全 部 特性 。 
在 注解 @EnableZuulproxy 的 基础 上 , 还 可 在 ApiZuulServiceApplication 类 之 前 加 入 一 个 注 
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ffF(gQ)EnableDiscoveryClient. FH 7/3 7R J api-gateway-service 应 用 程序 的 main 应 用 程 
TFE 


package com.dineshonjava.apizuulservice; 

import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.cloud.client.discovery.EnableDiscoveryClient; 
import org.springframework.cloud.netflix.zuul.EnableZuulProxy; 
aEnablezuulProxy 

aEnableDiscoveryClient 

aSpringBootApplication 

public class ApiZuulServiceApplication | 

public static vod maidiniString[| args} I 
SpringApplication.run(ApiZuulServiceApplication.class, args); 

} 

} 


可 以 看 到 ，ApiZuulServiceApplication 关 及 用 @EnableZuulProxy 进行 注 骨 ， 以 司 用 微 
服务 应 用 程序 中 的 Zuul 代理 服务 。 接 下 来 者 人 租 如 何在 application.properties 或 application. 
yml 文件 中 配置 Zuul 属性 。 有 具体 来 说 ， 本 章 使 用 了 application.yml 文件 对 Zuul 属性 进行 配 
E CN. IRI bootstrap.properties 文件 实现 应 用 程序 司 动 时 所 需 的 配置 项 。 


7.2.3 配置 Zuul 属性 


381 application.yml 配置 文件 ， 下 面 将 配置 应 用 程序 中 的 Zuul 属性 ， 如 下 所 示 : 


spring: 

application: 

name: API-GATEWAY 
Server: 

port: 8080 

eureka: 

client: 

service-url: 
default-zone: ${EUREKA URI:http://localhost:8761/eureka] 
instance: 
prefer-ip-address: true 
züuul: 

ignoredServices: '*' 
prefix: /api 


routes: 
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account-service: 

path: /accounts/** 

serviceld: ACCOUNT-SERVICE 

customer-service: 

path: /customers/** 

serviceld: CUSTOMER-5ERVICE 

host:socket-timeout-millis: 30000 

在 上 述 应 用 程序 配置 文件 中 ， 应 用 程序 名 称 定 义 为 API-GATEWAY, Edge Service 
应 用 程序 的 服务 器 端口 为 8080。 对 于 基于 Eureka Server 的 边缘 服务 的 注册 行为 ， 代 码 中 
还 定义 了 与 Eureka 客户 疹 相 关 的 配置 项 。 


O xz. 

Je RR ZEE] TR AID 的 路 由 机 制 , 则 需要 在 类 路 径 上 提供 Eureka, 并 利用 Eureka 注 
册 服 务 器 注册 该 项 服务 。 上 此外， 还 可 不 通过 Eureka 服务 器 使 用 Zuul, 但 需要 提供 服务 重 定向 
的 准确 的 URL, 2v zuul.routes.account-service.url-http://localhost:6060 ., 


最 后 ， 我 们 在 应 用 程序 配置 文件 中 配置 了 Zuul 属性 。 首 先 ， 通 过 下 列 配置 省 略 Zuul 
代理 中 的 所 有 默认 服务 : 

zuul: 

ignoredServices: !*'! 

account-service: 

path: /accounts/** 

具体 来 讲 ， 除 了 account-service 之 外 ， 所 有 服务 均 被 忽略 。 

另外 还 可 针对 URL 使 用 一 个 公共 前 级 , 如 as/api, 我 们 希望 Zuul 通过 设置 zuul.prefix 
属性 实现 代理 ， 如 下 所 示 : 

zuul: 


prefix: /api 
mH, xenp BERERE, Wn hr: 


zuul: 

routes: 

account-service: 

path: /accounts/** 
serviceld: ACCOUNT-SERVICE 


XE, zuulroutes.account-service.path 将 路 由 所 有 传输 内 容 ， 并 利用 ACCOUNT- 
SERVICE 服务 ID 请 求 服 务 。 当 前 ，http://localhost:8080/api/accounts/account 将 被 转发 至 
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ACCOUNT-SERVICE 做 服务 。 下 面 配 置 另 一 个 微服 务 Customer， 访 服务 与 当前 示例 中 的 
Account 微服 务 较为 类 似 。 

最 后 ， 下 列 配置 用 于 设置 Zuul 主机 套 接 字 超 时 : 

zuul: 

host: 

socket-timeout-millis: 30000 

上 述 配置 说 明 ，Spring Boot 将 等 待 啊 应 30000 ZF. 

目前 ， 可 运行 API Gateway 服务 的 微服 务 应 用 程序 ， 并 对 其 进行 测试 。 对 此 ， 局 动 
Eureka Server. AccountService, CustomerService 和 APIZuulService 应 用 程序 。 

利用 http://localhost:8761/1] 7F Eureka Dashboard， 对 应 结果 如 图 7.4 所 不 。 


Instances currently registered with Eureka 


Application AMIs — Availability Zones Status 
ACCOUNT-SERVICE  n/a(1) (1) 
API-GATEWAY n/a(1) (1) 


CUSTOMER-SERVICE n/a(1) (1) 


图 7.4 


在 图 7.4 中 ， 可 以 看 到 3 项 微服 务 处 于 运行 状态 ， 并 利用 Eureka 了 予以 注册 。 

针对 目 定 义 UI 应 用 程序 ， 输 入 Customer 服务 的 URL, | BI http://localhost:8080/api/ 
customers/customer/1001. 1% URL 将 通过 http://localhost:6161/customer/1001 于 内 部 被 路 由 
至 Customer 服务 。 

图 7.5 显示 了 使 用 API 网 关 http://localhost:8080/api/customers/Customer/1001 调用 
Customer 服务 的 公共 API。 

这 里 利用 API Gateway Zuul 代理 调用 了 Customer 微服 务 。 从 内 部 来 看 , 该 Zuul 代理 
利用 http://localhost:6161/customer/1001 调用 了 Customer 服务 。 类 似 地 ，Account UI 组 件 
可 通过 API Gateway Zuul 代理 服务 Chttp://localhost:8080/api/accounts/account/100) 调用 
Account 做 服务 ， 如 图 7.6 所 示 。 

此 处 利用 API Gateway Zuul 代理 调用 了 Account 做 服务 。 从 内 部 来 看 ， 这 将 通过 
http://localhost:6060/account/100 调用 实际 的 服务 。 


1.2.4 
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2 localhost8080/api/custc: Xx H — Y 
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— © © localhost:8080/api/customers/customer/1001 


customerId: 1001, 
customerName: “Arnav Rajput", 
mobile: "54312XX223", 
email: "arnavxxx(imail.com", 
city: "Noida", 

- account: [ 


accountlId: 1981, 
balance: 3502.92, 
customerId: 1001, 
accountType: "SAVING", 
branchCode: "ICICIOO1", 
bank: "ICICI" 


accountId: 200, 
balance: 3122.05, 
customerId: 1001, 
accountType: "CURRENT", 
branchCode: "HDFCO02", 
bank: "HDFC" 


图 7.5 


' gy localhost8080/api/acco. X WN 


=- Er | © localhost:8080/api/accounts/account/100 


1 


accountlId: 100, 


balance: 3582.92, 
customerId: 160600, 
accountType: "SAVING", 
branchCode: "HDFCO8O81", 
bank: "HDFC" 


图 7.6 


s JD SLE Bs 


此 外 ， 我 们 还 可 在 Zuul 微服 务 中 添加 自 定 义 


过 


kh] 
^ 
We AN 3 


以 实现 革 些 横 切 关系 Ceross- 
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cutting concern) ， 例 如 安全 性 和 速率 限制 。 之 前 曾 讨 论 了 4 种 过 滤器 ， 即 pre. post. route 
和 error。 对 此 ， 可 通过 扩展 com.netflix.zuul.ZuulFilter 类 生成 这 些 过 滤器 。 相 应 地 ， 需 要 
重 载 filterType. filterOrder. shouldFilter 和 run 方法 。 下 列 代 码 显示 了 PreFilter 自 定 义 过 


package com.dineshonjava.apizuulservice.filters; 
import java.util.UUID; 

import javax.servlet.http.HttpServlethRequest; 
import com.netflix.zuul.zZzuulFilter; 

import com.netflix.zuul.context.RequestContext; 
import com.netflix.zuul.exception.ZuulException; 
public class PreFilter extends ZuulFilter{ 
aOverride 

public Object run() throws ZuulException 1 
RequestContext ctx = RequestContext.getCurrentContext(); 
HttpServletRequest request - ctx.getRequest(); 

if (request.getAttribute("AUTH HEADER") == null) { 
/ {generate or get AUTH TOKEN, ex from Spring Session repository 
String sessionlid = UUID.randomUUTD().toString(í); 
cEx.addZuulRequestHeader ("AUTH HEADER", sessionld); 
} 

return null; 

} 

aOverride 

public boolean shouldFilter() f 

return true; 

} 

aOverride 

public int filterorder() 1| 

return 0; 

} 

aOverride 

public String filterType() | 

rerurn "pre": 

} 

} 


3813) A Netflix Zuul API 的 ZuulFilter 抽象 尖 ， 上 述 代 人 码 创 建 了 PreFilter。 类 似 地 ， 
还 可 创建 RouteFilter. PostFilter 和 ErrorFilter。 读 者 可 访问 GitHub 存储 库 并 获取 完整 的 
示例 代码 , 对 应 网 址 为 https://github.com/PacktPublishing/Mastering-Spring-Boot-2. 0. 在 上 
D IE ARAP, JH] RequestContext.addZuulRequestHeaderO Jf fE 7J iii 2K A Vis JI T 
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AUTH HEADER， 该 请求 头 将 被 转 友 全 内 部 做 服务 中 。 
在 创建 了 Zuul 过 滤器 后 ， 还 需要 定义 Bean 并 利用 Zuul 代理 服务 注册 这 一 类 过 滤器 。 
FAWXIBg ris Bean 定义 : 


aEnableZuulProxy 

aEnableDiscoveryClient 
aSpringBootApplication 

public class ApizZuulServiceAppltrication | 
public static void main(String[] args} 1 
SpringApplication.run(ApizuulServiceApplication.class, args); 
} 

aBean 

public PreFilter preFilter() | 

return new PreFilter(); 

} 

aBean 

public PostFilter postFilter() [| 

return new PostFilter(); 

} 

aBean 

public ErrorFilter errorFilter() | 
return new ErrorFilter(); 

} 

aBean 

public RouteFilter routeFilter() [| 
return new RouteFilter(); 

} 

} 


再 次 运行 当前 类 ， 并 针对 Customer 或 Account 态 问 任意 公共 API Gateway， 对 应 的 
得 出 结 末 如 图 7.7 所 示 。 


Console 23 | Ep Progress | Problems 


account-zuul-service - ApiZuulServiceApplication [Spring Boot App] C:\Program FilessJavaxre1.8.0 To6Tibinsjavaw.exe (1/-May-2018, 2:51:04 AM) 
Inside pre filter : GET Request URL : http://192.168.225.208:8080/api/customers/customer/1001 
Inside Route Filter 

Inside Post Filter 


图 7.7 


EFA OBI. AI http://192.168.225.208:8080/api/customers/customer/1001 API 
HHR, ETIE REAT. FEF TIT $8) B HH. 
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73 KẸ 0X 


本 章 针 对 微服 务 架 构 介 绍 了 API Gateway 模式 。 在 云 分 布 式 应 用 程序 中 ,API Gateway 
包含 了 诸多 优点 。 对 此 ， 本 章 讨 论 了 如 何 利用 Spring Cloud Netflix Zuul API 实现 API 
Gateway 代理 服务 。 

此 外 ， 本 章 还 实现 了 边缘 服务 ， 并 在 内 部 多 个 微服 务 之 上 提供 了 一 个 基于 Zuul 的 代 
理 服务 。 其 中 ， 边 缘 服 务 可 用 于 公共 功能 实现 或 横 切 关注 点 。 

最 后 ， 我 们 创建 了 多 个 Zuul 过 滤器 ， 并 通过 Zuul 代理 服务 进行 注册 。 

第 8 章 将 讨论 微服 务 应 用 程序 中 的 Feign 2$" ig o 


第 8 章 利用 Feign 客户 端 简化 HTTP API 


前 述 章 节 通 过 负载 平衡 的 RestTemplate、EurekaClient 和 DiscoveryClient 开发 了 微服 
务 及 其 客户 端 应 用 程序 。 其 中 ， 客 户 站 的 实现 方式 需要 使 用 到 大 量 的 样板 代码 ， 以 使 微 
服务 间 可 彼此 进行 通信 。 其 则 ， 我 们 还 学 习 了 Feign， 即 Netflix 开发 的 声明 式 HTTP 客 
Fi. 

本 章 将 对 Feign 及 其 工作 方式 加 以 深入 讨论 。 除 此 之 外 ， 本章 还 将 评 细 讨论 如 何 使 用 
HEXA MEA Hystrix 和 基于 单元 测试 的 开明 处 理 的 参考 实现 来 扩展 或 定制 
Feign， 进 而 满足 业务 需求 。 

同时 ， 我 们 还 将 学 习 Feign 如 何 简 化 HTTP API 客户 端 ， 且 仅 使 用 少量 样板 代码 生成 
HTTP API 客户 端 应 用 程序 以 访问 微服 务 。 对 此 ， 仪 需 简 单 地 设置 注解 接口 即 可 ， 实 际 实 
现 将 在 运行 期 内 完成 。 

在 阅读 完 本 章 后 ， 读 者 可 较 好 地 理解 声明 式 REST Jm. Feign 27/9, LA nf 
仅 通过 注解 接口 访问 微服 务 ， 且 无 须 杀 目 实 现 这 些 接口 。 

本 章 主要 涉及 以 下 主题 : 

Q Feign 基础 知识 。 

Feign 继承 机 制 |。 

ZERO. 

局 级 应 用 。 

Feign 和 Hystrix。 

日 志 机 制 。 

开间 处 理 。 

H E A II EU E 

对 Feign 2x Jm3t 11 Æ 763 iX « 


LDLLLLLLL 


8.1] Feign 基础 知识 


下 列 内 容 引 目 Feign 文档 : 
"Feign 是 一 个 Java 5 HTTP 之 间 的 客户 端 绑 定 器 ， 其 设计 灵感 来 自 Retrofit、 
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JAXRS-2.0 和 WebSocket. Feign 的 首要 目标 是 降低 将 Denominato 统一 绑 定 至 HTTP API 
过 程 中 产生 的 复杂 度 ， 且 不 考虑 RESTful”。 


Netflix 开发 了 一 个 声明 式 Web 服务 ， 即 Feign， 与 其 他 Web 服务 客户 疹 相 比 〈 例 如 
Spring 的 RestTemplate、DiscoveryClient 和 EurekaClient) ， 其 构建 过 程 较 为 和 何 单 。 当 生 
成 Feign REST 客户 端 时 ， 可 创建 一 个 接口 ， 并 利用 Netflix Feign 库 提 供 的 注解 标识 该 接 
口 。 男 外 ， 无 须 在 云 应 用 程序 中 实现 这 一 接口 并 使 用 到 微服 务 。Feign 2 P impet f 3H 
X MN Xt] HI AH Feign 注解 和 JAX-RS 注解 。 为 外 ， 还 可 使 用 Spring MVC fk, K 
Spring Web 模块 中 的 HttpMessageConverters。 对 于 REST 应 用 程序 ，Feign 客户 端 支持 
Spring MVC 模块 中 的 所 有 注解 ， 同 时 还 提供 了 可 插 拔 的 编码 器 和 解码 匿 。 默 认 状 态 下 ， 
Feign if; [| Ribbon 和 Eureka 中 的 各 项 功能 ， 从 而 可 提供 一 个 负载 平衡 的 客户 奖 。 

在 前 述 草 节 中 ， 兽 创建 了 微服 务 及 其 使 用 着 。 在 相关 示例 中 ，account-consumer (EP 
Web 应 用 程序 或 另 一 个 微服 务 CUSTOMER-CUSTOMERSERVICE ) 通过 RestTemplate 
使 用 account-service 公开 的 REST 服务 。 图 8.1 显示 了 在 不 使 用 Feign 情况 下 微服 务 的 应 
用 过 程 。 


使 用 Netflix 的 Fiegn 
注册 服务 (Eureka) 


仅 需 编写 Feign 
接口 


TT AM TET c < 
zik "account-service 注册 为 “account-service” 


Web 服务 — 账户 服务 L~» Accounts 
DB 


RESTful 请 求 JPA/SQL 
使 用 Feign 


图 8.1 


在 缺少 Feign ZPA mE hs 微服 务 彼 此 则 的 通信 和 需要 使 用 到 大 量 的 样板 代码 ， 这 
些 代码 多 与 Eureka. Ribbon 和 人 负载 均衡 机 制 相 关 。 同 时 ， 随 着 微服 务 数量 的 增长 ， 客 户 
新 应 用 程序 中 的 代码 也 将 变 得 更 加 复杂 。 下 列 需求 往往 会 涉及 较 多 的 代码 : 

2 ”对 于 吝 有 弹性 的 系统 来 说 ， 需 要 通过 Ribbon 创建 负载 平衡 的 客户 奖 。 

O ”使 用 Eureka 了 解 服务 实例 ， 然 后 了 解 微 服务 的 基本 URL. 
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Q EFXŤ account 微服 务 使 用 RestTemplate。 
下 列 代码 展示 了 如 何 使 用 account 做 服务 : 


package com.dineshonjava.webapplication.service; 
import Java.util.List; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.cloud.client.loadbalancer.LoadBalanceg; 
import org.springframework.stereotype.Service; 


import org.springframework.web.client.RestTemplate; 


import com.dineshonjava.webapplication.domain.Account; 


import com.dineshonjava.webapplication.exception.AccountNotFoundException; 


aService 
public class WebAccountsService [| 
aQGAutowired 
aQGLoadBalanced 
protected RestTemplate restTemplate; 
protected String serviceUrl - "http://ACCOUNT-SERVICE"; 
public Account getByNumber (String accountNumber) { 
Account account = restTemplate.getForObject(serviceUrl 
+ "/account/[accountId)", Account.class,accountNumber) ; 
if (account == null) 
throw new AccountNotFoundException (accountNumber); 
else 


return account; 


} 


FAEH Feign E BH3X REST 2s P! im. 并 得 看 如 何 解决 微服 务 通 信 所 产生 的 复杂 问题 。 
图 8.2 显示 了 采用 Feign 客户 疹 时 的 场景 。 

针对 Eureka, Ribbon 和 负载 平衡 机 制 ， 如 果 客 户 端 应 用 程序 的 类 路 径 上 涵盖 了 有 效 
的 库 或 依赖 关系 ， 对 应 代码 将 自动 被 添加 。 另 外 ， 甚 至 无 须 针 对 客户 端 代 码 编写 类 ， 仅 
需要 使 用 @FeignClient 注解 创建 一 个 接口 即 可 ， 同 时 采用 逻辑 服务 名 作为 注解 参数 。 这 
也 体现 了 一 种 较为 简单 、 清 晰 的 Netflix Feign 使 用 方式 。 如 果 Netflix Ribbon 依赖 关系 也 
位 于 类 路 径 中 ， 默 认 状 态 下 ，Feign 将 仅 关 注 负载 平衡 问题 。 
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使 用 Netflix 的 Feign 


注册 服务 (Eureka) 


仅 需 编写 Feign | 
接口 ' am 


j i di l ~! | 和 nmn - 
查找 “account-service 注册 为 “account-service” 


— 


Web 服务 Lp» Accounts 
DB 


RESTful 请 求 JPA/SQL 
使 用 Feign 


图 8.2 
接 下 来 考 租 如 何在 客户 症 应 用 程序 中 包含 Feign。 


82 在 云 应 用 程序 中 包含 Feign 


首先 ， 需 要 在 pom.xml 文件 中 包含 Netflix Feign 依赖 关系 ， 如 下 所 示 : 


«parent» 
«groupId»org.springframework.bootc«/groupId» 
«artifactId»spring-boot-starter-parent«/artifactId» 
«version»2.0.2.RELEASE-«/version» 
«relativePath/» «!-- lookup parent from repository 三 三 六 
«/parent» 


«properties? 
«spring-cloud.version»Finchley.M8«/spring-cloud.version» 


«/properties» 


«dependencies» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 

</dependency> 
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«dependency» 
«groupId»org.springframework.cloud«/groupId» 
«artifactlId»5spring-cloud-starter-netflix-eurekaclient«/artifactld» 
</dependency> 
<dependency> 
<grouplId>org.springframework.cloud</grouplId> 
<lartifactId>spring-cloud-starter-openfteign</artifactid> 
</dependency> 


</dependencies> 


当 在 客户 端 应 用 程序 项 目 (基于 Spring Cloud) 中 包含 Feign 时 ， 可 利用 基于 
org.springframework.cloud 和 spring-cloud-starter-openfeign 的 starter. 

下 面 通过 创建 带 有 @FeignClient 注解 的 接口 来 定义 一 个 Feign 27? tin. 该 接口 作为 一 
个 客户 端 工作 ， 进 而 访问 注册 于 发 现 服务 器 上 的 微服 务 。 这 里 的 问题 是 ， 如 何 访问 这 些 
服务 ? 对 此 , 需要 将 名 称 指定 为 @FeignClient yE f EH] accoun-tservice 7R N4 F Eureka 
的 、account 微服 务 的 逻辑 服务 名 ) 。 针 对 这 一 接口 ， 考 查 下 列 代 码 : 

package com.dineshonjava.customerservice.service; 

import jJava.-util.-List; 

import org.springframework.cloud.openfeign.FeignClient; 


import org.springframework.web.bind.annotation.GetMapping; 


import org.springframework.web.bind.annotation.PathVariable; 


import com.dineshonjava.customerservice.domain.Account; 


aFeignClient ("account-service") 
public interface AccountService [ 
QGetMapping (value = "/account/customer/iÍícustomer]") 
List«Account» findByCutomer (@PathVariable ("customer") Integer 
customer); 
aPutMapping(value = "/account/íaccountId])", consumes = 
"application/json") 
Account update (8PathVariable("storeld") Integer accountld, 
Account account): 
QGDeleteMapping (value = "/account/íaccountId)") 
void delete(GüPathVariable("accountId") Integer accountId); 
QGPostMapping (value = "/account/customer/", consumes = 
"application/json") 
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Account update(üRequestBody Account account); 


其 中 采用 了 包含 account-service 3? $HJlz 25 44 TJ (a)FeignClient("account-service")73: f- 
同时 ， 代 码 定 义 了 一 个 方法 调用 以 供 这 一 账户 REST 微服 务 使 用 ， 该 微服 务 基 于 /account/ 
customer/ {customer} 六 点 并 由 account-service 模块 所 公开 。 

当 确 保 @FeignClient 注解 处 于 工作 状态 时 , 需要 启用 应 用 程序 中 Feign 客户 端的 云 操 
作 行 为 。 最 后 ， 还 需要 利用 @EnableFeignClients 注解 Spring Boot main 类 。 相 应 地 ， 应 用 
程序 的 main 类 如 下 有 所 示 : 


package com.dineshonjava.customerservice; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 


import org.springframework.cloud.openfeign.EnableFeignClients; 


aSpringBootApplication 
aEnableFeignClients 


public class CustomerServiceApplication { 


public static void main(5tring[] args) I 


SpringApplication.run(CustomerServiceApplication.class, args); 


} 


接 下 来 创建 另 一 个 微服 务 CUSTOMER-SERVICE， 该 微服 务 将 访问 账户 微服 务 ， 进 
而 获取 银行 应 用 程序 中 与 茶 位 客户 关联 的 所 有 账户 。 下 列 类 通过 Feign 使 用 了 


accountService, "ll  Frzrs: 


package com.dineshonjava.customerservice.controller; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.web.bind.annotation.DeleteMapping; 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.PathVariable; 
import org.springframework.web.bind.annotation.PostMapping; 
import org.springframework.web.bind.annotation.PutMapping; 
import org.springframework.web.bind.annotation.RequestBody; 


import org.springframework.web.bind.annotation.RestController; 


import com.dineshonjava.customerservice.domain.Customer; 


import com.dineshonjava.customerservice.repository.CustomerRepository; 
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import com.dineshonjava.customerservice.service.AccountService; 


aRestController 
public class CustomerController | 

aQAutowired 

CustomerRepository customerRepository; 

aQAutowired 

AccountService accountService; 

QGPostMapping (value = "/customer") 

public Customer save (RequestBody Customer customer) { 
return customerhRepository.save(customer); 

} 

@GetMapping (value = "/customer") 

public Iterable<Customer> all (){ 
return customerRepository.findAll(); 

} 

@GetMapping (value = "/customer/{customerId}") 

public Customer findByAccountId (GPathVariable Integer customerId){ 
Customer customer = customerRepository.findByCustomerId (customerld); 
customer.setAccount (accountService.findByCutomer (customerId)); 
return customer; 

} 

@PutMapping (value = "/customer") 

public Customer update (@RequestBody Customer customer) { 
return customerhRepository.save(customer); 

} 

@DeleteMapping (value = "/customer") 

public void delete (GRequestBody Customer customer) { 
customerRepository.delete (customer); 


accountService.delete (customer); 


} 

采用 注解 @FeignClient 的 接口 AccountService 已 与 客户 微服 务 的 控制 器 类 上 自动 连接 。 
iulii GtiHub AA sg SEBIqHR AS ZI Vd CAccountService. CustomerService 和 
Web 应 用 程序 服务 ) ， 对 应 网 址 为 https:Wgithub.com/PacktPublishing/Mastering-Spring- 
Boot-2.0. 


O +s. 
Feign 客户 端 仅 用 于 基于 文本 的 HTTP API, 这 意味 着 , CARARE, LAEN TF 
载 等 操作 。 
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下 面 结合 Eureka Server 运行 上 述 微服 务 ， 图 8.3 显示 了 包含 Eureka 注册 服务 的 控制 
人 台 输 出 结果 。 


Initializing Spring FrameworkServlet 'dispatcherServlest' 
FrameworkServlet 'dispatcherServlet': initialization started 
FrameworkServlet 'dispatcherServlet': initialization completed in 34 ms 


Registered instance CUSTIOMER-SERVICE/MRNDTHTMOBLOO02.timesqroup.com:customer-service:6161 with status UP (replicationzfalse) 
Registered instance ACCOUNT-SERVICE/MRNDTHIMOBLOOO2.timesgroup.com:account-service:6060 with status UP (replication-false) 


图 8.3 


当 访 问 客户 微服 务 端 点 http://192.168.225.208:6161/customer/1001 时 ， 将 获取 与 客户 
相关 的 信息 (对 应 ID 为 1001) ; 同时 , 还 将 从 账户 微服 务 中 获取 与 该 客户 相关 联 的 账户 。 
对 应 输出 结 未 如 图 8.4 Bran 

a 192.168.225.208:6161/c. x WW 


€ © | 192.168.225.208:6161/customer/1001 


customerId: 1001, 

customerName: "Arnav Rajput", 

mobile: "54312XX223", 

email: "arnavxxxgmail.com", 

city: "Noida", 

- account: [ 
X 

accountlId: 101, 
balance: 3582.92, 
customerId: 1001, 
accountType: "SAVING", 
branchCode: "ICICIOGO81", 
bank: "ICICI" 


accountlId: 200, 
balance: 3122.85, 
customerId: 1001, 
accountType: "CURRENT", 
branchCode: "HDFCOG02", 
bank: "HDFC" 


图 8.4 


在 当前 示例 中 ， 存 在 两 个 与 客户 ID 1001 HARRIKA. F: 
客户 端的 默认 配置 。 


-| 


考查 如 何 重 载 Feign 
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8.2.1 Æ Feign 的 默认 配置 


通过 FeignClientsConfiguration， 默 认 配 置 将 被 每 个 Spring Cloud Feign 加 以 使 用 。 
Spring Cloud 根据 需要 通过 FeignClientsConfiguration 文件 并 针对 每 个 命名 客户 疹 创 建 了 
新 的 配置 上 下 文 。 访 配置 文件 包 侣 了 几乎 全 部 所 需 的 FeignClient 属性 ， 如 feign.Decoder. 
feign.Encoder 、 feign.Contract o 但 Spring Cloud 还 可 重 载 此 类 配置 属性 ， 即 在 
FeignClientsConfiguration 之 上传 加 额外 的 配置 文件 。 

Spring Cloud Netflix 作为 针对 Feign 的 默认 配置 ， 提 供 了 下 列 Bean. 
Decoder feignDecoder: ResponseEntityDecoder jE | feignDecoder Bean. 
Encoder feignEncoder: SpringEncoder 类 所 供 y feignEncoder Bean. 
Logger feignLogger: SlfAjLogger Kett | feignLogger Bean. 
Contract feignContract: SpringMvcContract tett y feignContract Bean. 
Feign.Builder feignBuilder: HystrixFeign.Builder 类 提供 了 feignBuilder Bean. 
Client feignClient: WWR JH | Ribbon 则 表示 为 LoadBalancerFeignClient， 含 则 
为 使 用 默认 的 Feign 客户 端 。 
当 采 用 目 定 义 配置 文件 或 配置 属性 文件 (YMAL 或 属性 ) 时 ， 可 重 载 上 述 列 出 的 全 


LDLLLLL 


部 Feign MAALE. -o 
Ar FIERA]: 
aFeignClient (name = "account-service", configuration = 


AccountConfiguration.class) 
public interface AccountService 1 
"m 
} 
"1H, AccountService 可 供 FeignClientsConfiguration 和 AccountConfiguration 配置 使 
用 ， 但 相同 的 属性 也 可 被 AccountConfiguration 文件 中 的 属性 所 重 载 。 


在 Feign 客户 端 配置 中 , 无 须 利用 @Configuration 标注 AccountConfiguration 类 。 如 果 采 用 
@Configuration 对 其 进行 标注 ， 则 应 注意 将 其 从 @ComponentScan 中 予以 排除 ， 其 原因 在 于 ， 
该 配置 将 成 为 feign.Decoder, feign.Encoder, feign.Contract 等 的 默认 源 。 因 此 ， 须 避免 将 其 与 
公共 配置 文件 放 在 一 起 ， 并 将 该 文件 置 于 与 任何 ComponentScan 或 (@SpringBootApplication 不 
重合 的 独立 包 中 ; 或 者 ， 也 可 显 式 地 从 (@ComponentScan 组 件 扫描 中 排除 该 配置 文件 。 
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(QFeignClient 注释 还 支持 该 注解 的 名 称 和 URL 属性 中 的 占 位 符 。 考 查 下 列 示 例 : 


aFeignClient (name = "S[(feign.name]", url = "$S[feign.urlj]j", configuration 
— AccountConfiguration.class) 
public interface AccountService [| 
frea 
} 


下 列 配置 文件 将 与 @FeignClient 协同 使 用 : 


aConfiguration 

public class Accounttonfi1quration | 
Bean 
public Contract reudsdqgnContract () 1 


return new feign.Contract.Default (); 


aBean 
public BasicAuthRequestInterceptor basicAuthRequestInterceptor() | 


return new BasicAuthRequestInterceptor("user", "password"); 


} 
上 述 配置 文件 利用 feign.Contract.Default & 1$ 了 SpringMvcContract, 同时 还 添加 了 一 


^* RequestInterceptor Bean. 


Spring Cloud 还 可 利用 配置 属性 重 载 @FiegnClient 注解 的 默认 配置 , 考查 下 列 .yml 文件 : 


feign: 
client: 
config: 
feignName: 

connectTimeout: 5000 

readTimeout: 5000 

loggerLevel: full 

errorDecoder: com.dineshonjava.decode.CustomErrorDecoder 

retryer: com.dineshonjava.CustomRetryer 

tegquestintercepEors: 
- com.dineshonjava.interceptor.AccountRequestInterceptor 
— com.dineshonjava.interceptor.CustomRequestInterceptor 

decode404: false 

encoder: com.dineshonjava.CustomEncoder 

decoder: com.dineshonjava.CustomDecoder 


contract: com.dineshonjava.CustomContract 
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Spring Cloud 还 可 在 @EnableFeignClients 属性 中 设置 默认 配置 ， 即 defaultConfiguration. 
(Q)EnableFeignClients 注解 中 给 定 的 配置 将 作用 于 所 有 的 Feign 客户 靖 。 考 但 下 列 代码 : 


package com.dineshonjava.customerservice; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 


import org.springframework.cloud.openfeign.EnableFeignClients; 


aSpringBootApplication 
aEnableFeignClients(defaultConfiguration-BasicFeignConfig.class) 
public class CustomerServiceApplication { 


public static void main(Strtng[] args) | 


SpringApplication.run(CustomerServiceApplication.class, args); 
} 


假设 项 目 中 同时 存在 @Configuration Bean 和 配置 属性 ， 那 么 ， 配 置 属 性 将 被 优先 使 
Hj. 配置 属性 文件 重 载 了 @Configuration 值 。 当 然 , 也 可 将 feign.client.default-to-properties 
设置 为 false， 进 而 修改 @Configuration 的 优先 权 。 

Spring Cloud 还 可 通过 手动 方式 创建 Feign 客户 端 ， 下 面 将 对 此 加 以 讨论 。 


8.2.2 创建 Feign X Pss; 


利用 Feign.builderO0， 还 可 创建 自己 的 Feign 客户 端 ， 并 配置 基于 接口 的 客户 端 。 下 
列 类 使 用 同一 接口 创建 了 两 个 Feign 2€)" tin: 


@Import (FeignClientsConfiguration.class) 
aRestController 
class CustomerController | 

private AccountService customerAccuntService; 


private AccountService adminAccuntService; 


QAutowired 
public CustomerController( 
Decoder decoder, Encoder encoder, Client client, Contract contract) { 
this.customerAccuntService = Feign.builder().client (client) 
-encoder (encoder) 
. decoder (decoder) 


-contract (contract) 
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.requestInterceptor (new BasicAuthRequestIinterceptor ("customer", 
"customer")) 
target(AccountServiceo.class, "http://ACCOUNT-SERVICE"); 


this.adminAccuntService = Feign.builder().client (client) 
.encoder (encoder) 
.decoder (decoder) 
-Contract (contract) 
.requestiInterceptor (new BasicAuthRequestInterceptor ("admin", 
"acdmin") ) 
.target(AccountService.class, "http://ACCOUNT-SERVICE"); 
i 
} 
此 处 通过 Feign Builder API 创建 了 两 个 AccountService 类 型 的 Feign 客户 站， 即 


cutomerAccountService 和 adminAccountService. 


8.2.3 Feign 继承 机 制 


除 此 之 外 ， 还 可 使 用 继承 接口 的 方式 避免 同一 服务 类 型 的 样板 代码 。Feign 可 将 公共 
操作 分 组 至 基 接 口中 。 考 查 下 列 代 人 码 示例 : 


QFeignClient (name-"account-service") 

public interface AccountService 1 
QGetMapping (value = "/account/customer/ícustomer]") 
List«Account» findByCutomer (G8PathVariable("customer") Integer 


customer); 
} 


在 男 一 个 FeignClient 服务 的 构建 过 程 中 ， 可 继承 该 接口 ， 如 下 所 示 : 


aFeignClient ("users") 


public interface AdminAccountService extends AccountService { 


824 多 重 继承 


Spring Cloud Netflix 支持 多 个 Feign 客户 疹 接 口 的 创建 ， 并 定义 为 Target<T>， 这 将 
支持 执行 前 的 动态 发 现 和 装饰 请 求 ， 如 下 所 示 : 
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AccountService accountService = Feign.builder().target (new 


CloudIdentityTarget«AccountService» (user, apiKey)); 


8.3 Feign & P 35 0 ej ZR. Jf] 


Feign XERME EAEL 1208 BITES RARA P AFERRA 08 TH [8] RE oi 
例 。 对 此 ， 可 创建 一 个 基 API 接口 ， 且 特定 的 API 接口 将 继承 目 该 接口 。 
AE PEDIR: 


interface BaseAPI«T» ( 
aGetMapping ("/health") 
To gelij; 


&GetMapping ("/all") 
Listei allii; 
} 


下 面 通过 继承 上 述 基 接口 方法 ， 定 义 一 个 特定 的 API 接口 ， 如 下 所 示 : 


interface CustomAPI extends BaseAPI<T> [( 
aGetMapping ("/custom") 
T customt):; 


} 


有 时 ， 资 源 表 示 也 是 一 致 的 。 因 此 ， 可 声明 并 接收 基 API 接口 中 的 类 型 参数 ， 并 将 
这 一 基 API 接口 继承 至 特定 的 接口 上 。 


QGHeaders("Accept: application/json") 
interface BaseApic«T» { 


aGetMapping ("/api/Ííkey])") 
T get(GPathVariable("key") String key); 


aàGetMapping ("/api") 

List- T lis (); 

@Headers ("Content-Type: application/json") 
@PutMapping ("/api/{key}") 

void put (@PathVariable ("key") String key, T value); 


* 158* 精通 Spring Boot 2.0 
interface AccountApi extends BaseApi«Account»^» { ] 


interface CustomerApi extends BaseApi«Customer» { ] 


根据 具体 要 求 ， 可 通过 继承 机 制 和 定义 基 API 接口 的 方式 开发 API 接口 ， 这 一 类 接 
口 用 于 与 《〈 头 文件 和 啊 应 ) 资源 表示 相关 的 公共 约定 和 公共 配置 。 

如 前 所 述 , 日 志 对 于 每 个 项 目 来 说 都 十 分 重要 。Feign 客户 应 仅 啊 应 于 DEBUG 级 别 ， 
狱 认 状态 下 ， 日 将 的 文件 名 雪 示 为 创建 Feign 客 尸 病 的 接口 的 完整 关 名 。 相 应 地 ， 需 要 对 
每 个 Feign 客户 新 创建 日 志 。 退 过 设置 配置 属性 中 的 logging.level.project.user.UserClient, 
还 可 进一步 修改 日 志 级 别 。 

考查 下 列 application.yml 配置 文件 : 

e 

level: 
project: 


UserClient: debug 
RTA UPUNLFRREHRE HERAA, AMAA P Br. 
Q NONE: 日 志 机 制 处 于 茶 用 状态 《默认 状态 ) 。 
OD BASIC: 该 日 志 级 别 对 应 于 请 求 方法 、URL、 啊 应 状态 码 和 执行 时 间 。 
OD HEADERS: 该 日 志 级 别 对 应 于 连同 请 求 和 啊 应 头 的 基本 信息 。 
D FULL: 该 日 志 级 别 对 应 于 请 求 和 啊 应 的 数据 头 、 数 据 体 和 元 数据 。 
通过 Feign AP im Java 配置 文件 ， 可 定义 日 志 级 别 。 考 租 下 列 示 例 ， 其 中 ， 
Logger.Level ix & 7j FULL: 

aConfiguration 
public class AccountConfiguration [ 

QBean 

Logger.Level feignLoggerLevel() I 


return Logger.Level.FULL; 
} 
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默认 状态 下 ，Spring Cloud Netflix Feign 针对 任意 类 型 错误 将 抛 出 FeignException, 但 
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这 并 非 总 征 运 家 司 一 开间 并 个 适用 于 项 目 中 的 各 种 情况 。 对 此 ，Netflix Feign H x Et 
目 己 的 应 用 程序 异 稼 。 通 过 将 feign.codec.ErrorDecoder 目 定 义 实现 提供 至 Feign.builder. 
errorDecoder0， 我 们 可 轻松 地 实现 这 一 任务 。 

AA P ErrorDecoder 实现 : 


public class AccountErrorDecoder implements ErrorDecoder { 


GQGOverride 
public Exception decode (String methodKey, Response response) 1 
if (response.status() >= 400 && response.status() <= 499) { 
return new AccountClientException( 
response.status(), 
response.reason() 
) ; 
} 
if (response.status() >= 500 && response.status() <= 599) { 
return new AccountServerException( 
response.status(), 
response.reason() 
) ; 
] 


return errorStatus (methodKey, response); 
} 
当前 ， 可 以 通过 提供 Feign.builder0 来 使 用 前 面 创建 的 异常 。 查 看 下 列 示例 代码 ; 


return Feign.builder() 
.errorDecoder (new AccountErrorDecoder()) 


-target (AccountService.class, url); 


AccountErrorDecoder 为 Feign Builder API KA. f —^h HE X fva. XER 
只 是 在 Feign 客户 端 中 添加 了 一 个 自 定义 的 错误 解码 器 .相应 地 ,我 们 可 以 为 Feign Builder 
API 81 ££ H XE XE di Tn R3 A o 
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Feign Builder API 可 为 Feign 2€" imahe A xE X Aha ARER) 以 及 解码 左 〈 针 
对 啊 应 ) 。 
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8.5.1 BXEXfRh3zs 


JC A ESTEE IZ HS BU E —^ El XE X. SR R3 o 
利用 String 或 byte[] 参 数 并 通过 POST 方法 ， 请 求 体 数据 被 发 送 至 服务 器 中 。 另 外， 
还 可 添加 一 个 Content-Type 头 ， 如 下 所 示 : 


interface AccountService f{ 
@PostMapping ("/account/") 
@Headers ("Content-Type: application/json") 
Account create (@RequestBody Account account); 


} 


接 下 来 配置 自 定 义 编 码 占 ， 当 前 表示 为 类 型 安全 的 请 求 体 。 下 和 面 考查 基于 feign-gson 
打 展 的 相 天 示例 : 


class Account 1 
Integer accountId; 
Double balance; 
Integer customerId; 
String accountType; 
String branchCode; 
String bank; 


public Account (Integer accountlId, Double balance, Integer customerld, 
String accounttype, String branchtode, String bank) 1 

super (); 

thrs.acoountlid = accountlId; 

this.balance - balance; 

Lthrs.customerlid = customerIcd; 

this.accountType = accountTvype; 

this.branchCode - branchCode; 

this.bank = bank: 


interface AccountService f 
QPostMapping ("/account/") 
QHeaders("Content-Type: application/json") 


Account create (@RequestBody Account account); 
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AccountService client = Feign.builder () 
.encoderí(new GsonEncoder()) 
.target(AccountService.class, 
"http://ACCOUNT SERVICE"); 


client.create(new Account (1001, 2304.32, 100, 'SAVING', 'HDFCOO011', 
CHDERC 13; 


8.5.2” 自 定义 解码 器 


Feign.builder() 可 创建 一 个 目 定 义 解码 占 , 2E TU EZ f S JI 2E. Feign 客户 端的 配置 
中 以 对 啊 应 进行 解码 。 对 此 ， 如 果 接 口 返回 菜 些 目 定义 类 型 ， 或 者 除 Response, String, 
byte[]、void 之 外 的 类 型 ， 则 需要 配置 一 个 非 默认 解码 器 。 考 得 下 列 基于 feign-gson 扩展 
的 对 应 示例 : 
AccountService client = Feign.builder() 
.decoder (new GsonDecoder()) 
.target(AccountService.class, "http://ACCOUNT- 
GEBVICE"): 
在 上 述 代码 中 可 以 看 到 ，GsonDecoder 作为 响应 解码 器 被 添加 至 当前 Feign 客户 端 中 。 
此 外 ， 这 里 还 针对 Feign 客户 端 创建 了 一 个 自 定义 解码 器 
Netflix Feign 针对 有 断路 器 模式 支持 Hystrix 的 使 用 ， 接 下 来 将 对 此 加 以 讨论 。 


8.6 Feign 和 Hystrix 


-AMJEEHOH SRTETRRAUER) SEL]. mK EAMAN, WUNDER GRAIN. XS 
Hystrix, Feign 文 持 断 路 器 模式 。 本 市 将 讨论 Hystrix 以 及 如 何 编 写 回 退 方法 。Feign 客户 
端 针 对 回 退 提供 了 较为 直接 的 支持 。 如 果 Hystrix 位 于 类 路 径 上 且 feign.hystrix.enabled= 
true, Feign 即 会 用 断路 堪 来 封装 所 有 的 方法 。 

当 实 现 基 于 Hystrix 的 Feign 客户 病 时 ， 只 需 使 用 回 退 代 码 实 现 接口 ， 当 对 闯 点 的 实 
际 调用 产生 错误 时 ， 将 使 用 回 退 代码 。 

Aft PAHVIZR DI 

aFeignClient (name = "account-service", fallback = 


HystrixClientFalliback.class) 
interface HystrixClieont 1 
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aGetMapping ("/account/[(accountId]") 
Account get(8PathVariable Integer accountId); 


class HystrixClientFallback implements HystrixClient [( 
aOverride 
public Account get() |l 
return new new Account(); 


} 

在 上 述 代 人 码 中 可 以 看 到 , 我 们 创建 了 及 用 @FeignClient 注解 的 HystrixClient 接口 ， 其 
中 涵盖 了 两 个 属性 ， 即 name 和 fallback。 这 里 ，fallback 属性 利用 HystrixClientFallback 
类 加 以 设置 ， 并 包含 了 一 个 回 退 方法 。 当 回路 打开 或 出 现 错误 时 ， 该 回 退 方法 将 被 执行 。 
@FeignClient 的 回 退 属性 将 回 退 至 实现 了 回 退 方法 的 类 名 处 。 

HystrixClientFallback 类 实现 了 HystrixClient 接口 ， 重 载 了 其 get0 方 法 ， 并 返回 一 个 
包含 默认 构造 器 的 account 对 象 。 

AAN, AA pL in e Sx B3B fh A as AED. xu. n fE(QFeignClient 中 使 用 
fallbackFactory 属性 ， 如 下 所 示 : 


aFeignClient (name = "account-service", fallbackFactory = 
HystrixClientFallbackFactory.class) 
protected interface HystrixClient { 

QGGetMapping ("/account/Í(accountId)") 

Account get(GüPathVariable Integer accountId); 


aComponent 
static class HystrixClientFallbackFactory implements 
FallbackFactory«HystrixClient» { 
QOverride 
public HystrixClient create (Throwable cause) { 
return new HystrixClient() 1 
QOverride 
public Account get() 1 
return new new Account ("fallback; reason was: ”十 


cause.getMessage ()); 
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上 述 内 容 曾 述 了 如 何 采 用 Feign X) mP HI Hystrix 确定 断路 器 模式 ， 这 也 使 得 当前 
系统 更 具 弹 性 。 另 外 ， 第 10 章 还 将 深入 讨论 Hystrix- 


O xs. 
在 Spring Cloud Dalston 发 布 之 前 ， 如果 Hystrix 位 于 类 路 径 上 , 默认 状态 下 ,Feign 将 所 有 
方法 封装 至 一 个 断路 器 中 。 在 Spring Cloud Dalston 中 ， 这 种 默认 行为 被 更 改 为 一 种 可 人选 方案 。 


最 后 ， 我 们 将 考查 如 何 利用 Feign 客户 端 在 云 应 用 程序 中 编写 单元 测试 。 
8.7 Feign 客户 端 单元 测试 


本 市 将 定义 一 个 单元 测试 类 ， 该 测试 类 包 售 了 多 个 测试 方法 。 但 在 当前 示例 中 ， 我 
们 仅 创 建 3 个 @Test 方法 测试 客户 痕 。 该 测试 将 使 用 org.hamcrest.CoreMatchers.* 和 
org.junit.Assert.* 数 据 包 中 的 静态 导入 操作 ， 如 下 所 示 : 


aTest 

public void findAllAccountTest() throws Exception | 
ErsteAccounte accounts = acconnt5ervice.fFindslit)- 
assertTrue(accounts.size() > 4); 

} 

aTest 

public void findOneAccountTest() throws Exception 1 

Account account = accountService.findByAccountId (1001); 
assertThat (account.getCustmer().getCustomerName(), 
containsString ("Arnav")); 

} 

aTest 

public void createAccountTest() throws Exception | 

Account account = new Account(1001, 2304.32, 100, 'SAVING', 
"HDEUCODITT “HDFC") 

accountService.create(account); 

account = accountService.findByAccountId (1001); 
assertThat(acconnt.getBank[), contarnss5tring(" HDEFC"))s 

} 

上 述 代码 编写 了 单元 测试 用 例 ， 以 测试 accountService Feign 客户 痕 。 在 第 一 个 测试 
方法 中 ,将 获取 列表 中 的 全 部 账户 一 一 列表 的 尺寸 须 大 于 5。 在 第 二 个 测试 方法 中 , 将 获 
取 1001 账户 ID 的 一 个 账 己 一 一 这 里 , 关联 客户 名 须 为 Amav。 在 第 三 个 测试 方法 中 , A] 
用 accountService Feign 客户 痕 创 建 了 一 个 账户 。 
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本 章 介 绍 了 Feign， 这 是 一 个 Netflix 发 布 的 一 个 声明 式 HTTP ZP im. RIZA T 
Feign 如 何 简 化 HTTP API 客户 闫 ， 且 无 顷 通 过 大 量 的 样板 代码 生成 HITP API 客户 端 ， 
进而 访问 微服 务 。 我 们 仅 需 简单 地 使 用 一 个 注解 接口 ， 而 实际 实现 将 在 运行 期 内 被 创建 。 

本 章 还 讨论 了 Feign 客户 端 ， 以 及 Hystrix 针对 Feign 客户 端的 支持 功能 。 另 外 ， 本 
章 还 实现 了 一 个 目 定 义 编码 器 /解码 器 ， 用 于 对 Feign 请 求 和 啊 应 进行 异 党 处理。 同时 ， 
我 们 还 创建 了 一 些 单元 测试 用 例 来 测试 Feign 客户 端 。 对 此 , 读者 还 可 以 学 习 使 用 和 定制 
相应 的 可 配置 选项 ， 如 日 志 记 录 和 请 求 压 缩 。 

第 9 章 将 介绍 事件 驱动 型 系统 。 


第 9 章 ”构建 事件 驱动 和 异步 响应 式 系 统 


本 章 将 深入 讨论 事件 驱动 架构 ， 进 而 作为 原生 云 应 用 程序 构建 事件 驱动 型 做 服务 。 
其 则 ， 我 们 将 考查 分 布 式 系 统 中 数据 一 至 性 处 理 背 后 的 一 些 较 为 重要 的 概念 和 主题 ， 并 
尝试 利用 Spring Cloud 和 Reactor ($ 10 章 将 对 此 予以 介绍 ) 构建 一 个 参考 应 用 程序 。 

前 述 章 节 曾 构建 了 微服 务 应 用 程序 ， 同 时 介绍 了 如 何 利用 Netflix Zuul API 针对 分 布 
式 应 用 程序 实现 了 路 由 机 制 ， 还 通过 声明 式 Feign 客户 端 实现 了 一 个 REST 2€" i. 

在 阅读 完 本 章 后 , 读 洗 将 能 够 较 好 地 理解 事件 驱动 型 淋 构 , 进而 了 解 如何 利 用 Spring 
Cloud Stream 构建 事件 驱动 型 和 异步 啊 应 式 系 统 。 本 章 将 通过 啊 应 式 编程 、 基 于 
ReactiveX 和 Reactive Spring 的 参考 程序 展示 异步 服务 通信 的 需求 条 件 和 解决 方案 。 

本 章 主 要 涉及 以 下 主题 ; 

DQ 事件 驱动 型 染 构 模式 。 

吧 应 式 编程 简介 。 

Spring Reactive. 
ReactiveX 

命令 查询 的 员 任 分 离 简 介 。 
Event Sourcing 人 简介。 
Eventual 一 致 性 简介 。 


构建 一 个 事件 驱动 型 啊 应 式 异 步 系统 。 


91 事件 驱动 型 架构 模式 
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应 。 这 是 一 种 较为 钊 见 的 弄 步 分 布 式 架构 ， 间 用 于 开发 高 伸缩 性 的 系统 。 

事件 驱动 型 淋 构 的 主要 目标 十 截取 事件 ， 并 采用 异步 方式 对 其 进行 处 理 。 事 件 驱 动 
型 染 构 主 要 涉及 两 种 拓扑 类 型 。 


9.1.1 调停 者 拓扑 


调停 者 拓扑 (Mediator topology) 包含 了 单一 事件 队列 ， 以 及 一 个 调停 者 ， 用 以 安排 
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队列 中 的 事件 ， 并 导向 至 各 自 的 处 理 器 中 。 随 后 ， 此 类 事件 将 从 事件 通道 中 被 传递 至 事 
件 的 过 滤器 或 预 处 理 器 中 。 

事件 队列 可 以 以 简单 的 消息 队列 或 在 大 型 分 布 式 系统 中 传递 消息 的 接口 的 形式 实 
现 。 其 中 ， 第 二 种 实现 形式 还 涉及 复杂 的 消息 传输 协议 ， 如 Rabbit MQ 和 Kafka. 


9.1.2 ”代理 拓扑 


代理 拓扑 并 不 包含 任何 事件 队列 。 实 际 上 ， 处 理 器 目 身 负责 析 取 事件 并 对 其 进行 处 
理 。 在 一 个 事件 处 理 完 毕 后 ， 处 理 器 将 指 回 另 一 个 事件 并 对 其 执行 析 取 和 处 理 操作 。 根 
据 拓 扑 的 含义 ， 处 理 器 在 此 表示 为 一 个 事件 链 的 代理 ， 处 理 某 个 事件 并 于 随后 推出 男 一 
个 事件 进行 处 理 ， 这 一 过 程 循环 往复 。 

一 些 事 件 驱 动 Web 框架 包括 以 下 方面 : 

Spring Reactor (Java) . 
ReactiveX ; 

Netty (Java) . 

Ver.X (JVM 语言 ) 。 
React PHP CPHP) . 

鉴于 事件 驱动 型 架构 具有 异步 特征 ， 因 而 该 模式 缺乏 原子 性 ， 因 为 事件 不 存在 可 用 
的 执行 序列 。 由 于 事件 处 理 器 具有 分 布 式 和 异步 特性 ， 因 而 相关 结果 期 望 在 未 来 任意 时 
刻 均 可 提供 结果 ， 这 很 可 能 取决 于 回调 的 顺 友 。 

考虑 到 事件 驱动 型 架构 的 异步 特性 ， 因 而 该 模式 的 测试 过 程 相对 困难 。 然 而 ， 由 于 
其 执行 过 程 中 的 异步 和 非 阻 窜 性 质 ， 事 件 驱 动 型 染 构 模式 的 性 能 仍 表 现 优异 。 这 也 使 得 
处 理 过 程 可 采用 并 行 方式 ， 且 不 存在 队列 机 制 所 产生 的 开销 。 

虽然 事件 驱动 型 架构 的 可 伸缩 性 较 高 ， 但 研发 成 本 也 将 成 倍增 加 。 有 具体 来 说 ， 尽 管 
该 模式 的 异步 特性 具有 较 高 的 可 伸缩 性 ， 但 这 也 使 得 该 模式 及 其 组 件 的 测试 机 制 较 为 困 
难 。 男 外 ， 此 类 架构 解 灯 特性 使 得 处 理 器 可 采用 并 行 方 式 处 理事 件 ， 这 种 并 行 机 制 进 一 
步 提升 了 可 伸缩 性 。 

事件 驱动 型 架构 模式 市 来 的 好 处 之 一 是 ， 应 用 程序 可 在 多 个 服务 器 和 多 项 服务 间 保 
持 数 据 的 一 致 性 ， 且 无 须 借 助 于 分 布 式 事务 。 然 而 ， 这 一 功能 也 使 得 完整 模型 变 得 更 加 
复 来 ， 也 束 古 说 ， 难 以 维护 、 难 以 开 友 。 为 外 ， 这 一 类 应 用 程序 还 可 目 动 更 狐 数 据 库 并 
发 布 事件 。 
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9.2 ”响应 式 编程 简介 


啊 应 式 编 程 是 用 非 并 发 信息 流 进行 目 定 义 。 这 意味 着 它 是 用 异步 数据 编码 的 。 
数据 流 含义 广泛 且 无 所 不 在 ， 任 何事 物 均 可 表示 为 数据 流 一 各 种 因素 、 客 户 端 输 
入 、 属 性 、 存 储 、 信 息 节 后 和 等。 例如， 可 将 某 个 推 符 频道 视 为 一 个 信息 流 ， 就 像 扫 摄 照 
片 一 样 ， 用 户 可 接收 该 数据 流 ， 并 在 必要 时 予以 啊 应 。 
在 此 基础 上 ， 我 们 还 将 持 有 一 个 工具 库 ， 用 于 强化 、 生 成 、 引 导 这 些 数据 流 。 这 期 
间 也 会 涉及 一 些 具体 的 操作 。 另 外 ， 一 个 数据 流 可 对 另 一 个 数据 流产 生 页 献 。 实 际 上 ， 
即使 是 不 同 的 数据 流 也 可 对 另 一 个 数据 流产 生 贡 献 结 果 。 相 应 地 ， 还 可 对 两 个 数据 流 进 
行 整合 ， 或 者 引导 某 个 数据 流 使 其 获得 另 一 个 所 关注 的 数据 流 。 最 后 ， 还 可 先期 考查 某 
个 数据 流 ， 并 于 随后 转 至 男 一 个 新 的 数据 流 。 
啊 应 式 编 程 的 具体 应 用 包括 以 下 几 点 。 
口外 部 服务 调用 : 当今 ， 大 量 的 后 端 服务 实现 了 REST 模型 ， 并 通过 HTTP 进 
tr BRE, 这 使 得 底层 协议 处 于 同步 和 阻塞 状态 。 外 部 服务 调用 可 避免 VO 结束 过 
程 中 的 等 待 行为。 
Q 并 发 消息 使 用 者 : 啊 应 式 编程 框架 中 的 消息 处 理 包 括 测量 微 基准 测试 ， 且 快速 
高 效 。 消 息 路 由 的 结果 以 每 秒 数 干 万 的 惊人 速度 出 现 。 
接 下 来 将 在 啊 应 式 编程 模型 的 基础 上 讨论 相关 技术 和 框架 。 


9.2.1 Spring Reactive 


Spring Reactive 是 一 个 基于 啊 应 式 编 程 的 、 针 对 Reactive Web 应 用 程序 的 框架 。 至 少 ， 
啊 应 式 编程 允许 使 用 非 阻塞 服务 创建 应 用 程序 。 大 多 数 基于 Java 的 应 用 程序 构建 于 
Servlet API E, Fx IR]IZE EH 2E38 X.» AA fU. 随 着 对 非 阻 暑 IO 和 异步 事件 支持 的 增加 ， 
Spring MVC RI, IMEEM MHATA HTTP 请 求 是 可 行 的 。 

另外， 在 现 有 的 框架 和 应 用 程序 环境 中 引入 非 阻 宫 IO 较为 困难 , 或 者 相对 低 效 。 对 
Jb. Spring Reactive 用 于 处 理 异 步 和 非 阻 圭 IO 问题 。 在 传统 的 Spring MVC 中 ， 针 对 
Reactive Web 应 用 程序 ，TestController 利用 集成 测试 将 应 用 程序 分 发 全 新 的 啊 应 式 引 擎 。 

针对 有 效 、 高 效 的 Spring Reactive 工作 机 制 ，Reactive Stream 规范 十 分 重要 ， 并 支持 
异步 组 件 提供 者 间 的 连接 ， 如 HTTP 服务 器 、Web 框架 、 数 据 库 驱动 程序 。 

Reactive Stream 规范 所 涉及 的 内 容 较 少 , NER T 4 个 接口 以 及 某 些 规则 。 当 组 建 异 
步 逻 辑 时 ，Reactive Stream 规范 需要 借助 于 某 个 基础 架构 ， 因 为 它 是 作为 API 公开 的 。 
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Spring Reactive 采用 Reactor Core 这 一 类 小 型 库 , 同时 也 是 构建 于 Reactive Stream 之 上 的 
函数 、 库 和 框架 的 基础 内 容 。 

最 终 的 质量 取 雇 于 同时 处 理 多 项 需求 的 能 力 ， 以 及 静态 处 理 相 关 操 作 的 能 力 ， 例 如 
从 远程 服务 器 中 请 求 信息 。 

Spring Reactive 编程 模型 文 持 非 阻塞 服务 和 应 用 程序 的 编写 ， 在 与 外 部 资源 交互 时 ， 
将 命令 式 编程 方法 转换 为 异步 的 、 非 阻 坚 、 函 数 式 代码 。 

这 里 需要 考查 以 下 3 种 场景 一 一 Java 8 CompletableFuture 作为 某 种 类 型 被 还 原 、 
RxJava 的 Observable 作为 人 采种 类 型 被 还 原 ， 以 及 Spring Reactor Core 的 Flux 


022 ReactiveX 


ReactiveX 是 一 个 异步 和 事件 驱动 程序 库 ， 通 过 扩展 观察 者 模式 以 支持 数据 和 事件 序 
列 。 其 中 包含 了 相关 的 操作 符 可 声明 序列 ， 同 时 不 必 担 心底 层 线 程 、 线 程 安全 、 同 步 和 
JEM 3€ IO 等 问题 。ReactiveX 具有 函数 式 、 啊 应 式 以 及 可 对 随时 间 变 化 的 离散 值 进行 操 
作 等 特征 。 

ReactiveX Observable 的 设计 目标 是 帮助 我 们 像 处 理 数 组 一 样 轻 松 地 处 理 异 步 事 件 ， 
并 消除 了 回调 机 制 的 复杂 性 ， 使 得 代码 更 具 可 读 性 ， 且 不 易 受 到 Bug 的 攻击 。ReactiveX 
Observable 包含 以 下 优点 : 

O ”组合 性 。ReactiveX Observable 模型 可 方便 地 生成 一 个 异步 事件 流 ， 并 对 多 个 事 
件 流 和 事件 序列 进行 整合 。 虽 然 其 他 技术 ， 例 如 Java Future， 也 可 用 于 异步 事 
件 ， 但 其 复杂 度 有 所 上 升 。 

口 ” 灵 活性。 该 模型 文 持 多 种 不 同 的 数值 类 型 ， 而 不 仅仅 是 标量 值 。 这 也 体现 了 该 
模型 的 灵活 性 和 优雅 性 。 

OD 多 样 性 。ReactiveX Observable 模型 可 通过 多 种 方式 加 以 实现 ， 例 如 线程 循环 、 
事件 循环 、 非 阻 窜 WO， 或 者 满足 相关 需求 条 件 的 其 他 实现 方式 ， 且 不 会 偏 癌 于 
特定 的 并 友和 开 步 源 。 

D ”消除 回调 。 在 异步 事件 的 能 和 侠 执 行 过 程 中 ， 回 调 会 在 代码 中 产生 很 多 问题 。 

口 “” 多 种 语言 实现 。ReactiveX 在 Observable 模型 中 实现 了 多 种 不 同 的 语言 。 

下 面 考 查 男 一 种 模式 ， 以 生成 啊 应 式 和 事件 驱动 型 系统 。 


9.3 ”命令 查询 的 贡 任 分 离 简介 


该 模式 基于 命令 查询 分 离 CQS) 这 一 概念 。 因 此 ， 根 据 CQS， 需 要 将 命令 和 得 询 
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分 开 ， 以 使 系统 更 具 啊 应 性 和 健壮 性 。 这 里 ， 命 令 意 味 着 得 询 癌 数 据 库 写 入 内 容 ， 并 改 
变 域 状态 ;， 坦 询 则 表示 准备 瓯 绪 且 不 改变 域 状态 的 询 。 

这 些 碍 询 行为 基于 源 上 自 数据 库 或 缓存 菜 处 的 就 绪 访 问 。 考 全 以 下 内 容 : 

DQ” 改变 系统 状态 的 命令 。 

DQ” 从 系统 中 获取 信息 的 查询。 

CQRS 与 条 些 染 构 模 式 较为 匹配 , 例如 基于 事件 的 编程 模型 。 营 见 的 情况 是 将 CQRS 
系统 划分 为 与 事件 协作 进行 通信 的 独立 服务 ， 以 使 这 些 服务 可 方便 地 利用 事件 源 (Event 
Massif 

这 种 架构 模式 改善 了 分 布 式 应 用 程序 的 性 能 ， 其 中 ， 应 用 程序 需要 处 理 复杂 的 域 驱 
动 编 程 。 因 此 ， 可 将 域 驱 动 模块 从 其 他 部 分 (基于 表示 和 只 读 的 数据 查询 ) 中 分 离 出 来 
我 们 可 利用 非 阻 窗 调 用 异步 地 使 用 消 明 传 递 或 事件 驱动 软件 架构 来 写 入 数据 库 。 考 查 如 
图 9.1 所 示 的 应 用 程序 染 构 ， 并 查看 CQRS 模式 如 何 应 用 于 系统 架构 中 。 


发 布 事件 以 更 新 缓存 


图 9.1 


可 以 看 到 ， 系 统 被 分 为 两 个 不 同 的 部 分 ， 如 只 读 得 询 〈 组 件 用 于 读 取 操作 ) 和 命令 
frg 〈 组 件 用 于 写 入 操作 ) 。 此 类 命令 负责 执行 茶 项 动作 ， 或 者 更 改 系统 状态 。 其 中 ， 
自主 组 件 表示 为 业务 逻辑 部 分 , 进而 可 更 新 Domain 模型 ， 并 通知 客户 端 该 变化 是 否 被 采 
纳 。 当 检测 到 任何 变化 时 ， 目 主 组 件 在 检测 到 变化 时 将 会 通知 所 有 人 。 在 图 9.1 rH, AC 
组 件 产生 一 个 域 事件 ， 更 新 数据 库 并 通知 另 一 个 AC 组 件 ， 进 而 更 新 应 用 程序 中 所 使 用 
的 绥 仓 内 容 。 
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第 二 部 分 则 是 用 于 客户 端 表示 的 查询 数据 ， 从 系统 中 获取 信息 且 不 改变 系统 的 状态 。 
这 一 部 分 内 容 仅 使 用 View 模型 ， 而 非 Domain 模型 。CQRS 模型 与 Domain 模型 和 View 
模型 间 关 注 点 分 离 相 关 ， 这 些 模型 可 以 异步 操作 ， 以 提高 应 用 程序 的 性 能 。 下 面 考 得 另 
一 种 与 CQRS 模式 结合 使 用 的 模式 ， 即 Event Sourcing 模式 。 


9.3.1 Event Sourcing 模式 简介 


根据 Event Sourcing 模式 ， 将 系统 状态 的 所 有 更 改 捕获 为 事件 序列 称 为 事件 源 。 

我 们 可 以 说 ， 系 统 中 的 所 有 信息 和 数据 都 以 事件 的 形式 进行 持久 化 ， 而 事件 只 不 过 
是 一 段 信息 ， 告 诉 系 统 已 经 发 生 的 操作 ， 例 如 域 的 创建 、 更 新 和 删除 。 生 成 后 的 事件 本 
质 上 是 不 可 变 的 ， 且 无 法 对 其 进行 修改 或 删除 。 因 此 ， 这 完全 基于 系统 中 所 友 生 的 事件 。 
如 果 系 统 中 产生 某 种 操作 ， 即 会 触发 事件 。 

Event Sourcing 背后 的 主要 概念 是 ,将 处 理 过 程 中 应 用 程序 状态 的 每 个 更 改 捕获 到 事 
件 对 象 中 。 此 类 事件 对 象 存 储 于 序列 中 ， 并 在 与 应 用 程序 处 理 范 围 相同 的 范围 内 被 触 友 。 

假设 分 布 式 应 用 程序 中 包含 了 两 个 微服 务 ， 即 Account 和 Customer， 对 于 添加 的 任 
何 新 客户 或 对 客户 数据 的 任何 修改 ， 我 们 都 希望 触发 对 客户 的 通知 。 除 此 之 外 ， 还 希望 
在 与 客户 相关 的 账户 发 生 任 何 更 改 时 触发 移动 通知 ， 如 图 9.2 Bra. 


牛 对 列 (Kafka) 


客户 服务 | 


电子 邮件 通知 移动 通知 
— 账户 处 理 中 发 送 移动 通知 的 事件 
addAccount() 


图 9.2 


在 图 92 中 可 以 看 到 ， 当 前 示例 引入 了 Event Sourcing 模式 ， 并 向 处 理 中 添加 了 一 个 
步 又。 当前 服务 创建 了 一 个 事件 对 象 ， 记 录 对 应 的 变化 并 对 其 进行 处 理 ， 进 而 更 新 客户 
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和 账户 信息 

基于 命令 查 询 职 贡 分 离 的 Event Sourcing 系统 中 包含 了 两 部 分 内 容 ， 即 命令 和 查询 。 
其 中 ， 命 令 查 询 与 数据 库 写 入 相关 ; 查询 则 与 前 端 数据 读 取 相关 。 但 是 ， 对 于 前 端 中 使 
用 的 这 一 关 模 型 来 说 ， 分 离 模 型 将 会 产生 数据 一 致 性 问题 。 下 面 讨论 如 何在 采用 最 终 一 
致 性 的 分 布 式 事件 驱动 型 系统 中 维护 数据 一 致 性 问题 。 


932 ”最 终 一 致 性 


对 于 实现 高 可 用 性 的 、 基 于 事件 的 分 布 式 应 用 程序 ， 最 终 一 致 性 是 一 类 一 致 性 模型 。 
如 果 在 系统 中 没有 对 域 进行 更 改 ， 那 么 它 将 返回 该 域 的 最 后 一 个 更 新 值 。 最 终 一 致 性 也 
称 作 乐观 复制 (optimistic replication) . 

在 如 图 9.1 所 示 的 CQRS 模式 示意 图 中 ， 我 们 采用 了 绥 存 返回 客户 并 发 送 的 查询 结 
采 。 因 此 ， 如 果 系 统 中 未 对 域 进行 任何 更 改 ， 绥 存 将 被 更 新 。 实 际 上 ， 几 了 乎 每 个 缓存 均 
基于 最 终 一 致 性 模型 。 

典型 情况 下 ， 在 需要 问 客 户 端 显示 数据 的 、 市 有 命令 租 询 责任 隔离 的 事件 源 系 统 中 ， 
须 包 含 3 个 彼此 协作 的 组 件 ， 如 图 9.3 所 示 。 


LE MESSIS) 
到 事件 ) 


视图 模型 
(GARE) CUI 模型 ) 


图 9.3 


不 难 友 现 ， 写 入 模型 将 接收 命令 ， 并 生成 数据 库 事 件 和 需要 更 新 的 缓存 ， 而 实际 模 
型 则 接收 事件 并 将 数据 对 象 返 回 至 前 闯 客 户 闯 。 


qu 精通 Spring Boot 2.0 


前 述 内 容 介 绍 了 与 事件 驱动 型 分 布 式 应 用 程序 相关 的 某 些 模式 ， 例 如 事件 驱动 型 架 
KJ . 命令 查询 职责 人 分离、 事件 源 和 最 终 一 致 性 模型 。 下面 将 和 尝试 使 用 消 晨 队列 , 例如 Kafka 
和 Spring Cloud Stream， 实 现 事 件 驱 动 型 异步 系统 。 


94 构建 事件 驱动 型 响应 式 异 步 系统 


本 太 将 构建 一 个 示例 项 目 , 进而 展示 如 何 利 用 事件 驱动 型 杂 构 、Spring Cloud Stream. 
Spring Boot, Apache Kafka. Spring Netflix Eureka 创建 一 个 实时 流 式 应 用 程序 。 如 图 9.4 


所 示 为 相应 的 应 用 程 厅 染 构 。 
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c 
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之 前 兽 采 用 了 Netflix Hystrix 实现 了 一 种 断路 器 模式 ， 第 10 章 还 将 对 此 加 以 深入 讨 
论 。 除 此 之 外 ， 我 们 还 利用 Netflix Zuu 配置 了 API 网 关 人 代理， 相关 内 容 参 见 第 7 章 。 

前 述 章 节 还 讨论 了 利用 微服 务 架 构 将 复杂 系统 解 耘 为 简单 、 独 立 的 微服 务 。 在 本 章 
中 ， 我 们 介绍 了 事件 驱动 型 微服 务 架 构 ， 这 可 视 作 一 种 用 于 生成 、 处 理事 件 和 实现 应 用 
程序 的 方法 学 ， 其 中 ， 事 件 在 解 耦 的 软件 组 件 和 服务 间 传 输 。 

接 下 来 将 利用 微服 务 (如 Account. Customer 和 Notification?) 构建 一 个 应 用 程序 。 
当 生 成 客户 记录 ， 或 某 位 客户 的 账户 时 ， 通 知 服务 将 发 送 一 封 邮 件 或 一 条 移动 通知 。 

当前 ， 我 们 持 有 3 MERKARI, EN Account. Customer 和 Notification， 有 是 全 部 均 是 
可 独立 部 署 的 应 用 程序 。 另 外 , 我 们 还 通过 Netflix Zuul 并 针对 API 网 关 生 成 了 边缘 服务 。 
其 中 ，Account 服务 可 用 于 创建 、 读 取 、 更 新 、 删 除 客 户 账 户 。 当 创建 一 位 新 客户 时 ， 
Account 服务 将 问 Kafka 主题 发 送 一 条 消息 。 

类 似 地 ，Customer 服务 用 于 创建 、 读 取 、 更 新 、 删 除数 据 库 中 的 一 位 客户 。 当 生成 
EMIA, Customer 服务 将 回 Kafka 主题 发 送 一 条 消息 。 此 外 ，Notification 服务 还 
将 肥 送 邮件 和 SMS 通知 。Notification 服务 监听 来 自传 入 的 客户 和 账户 消息 的 主题 ， 然 后 
通过 回 给 定 的 电子 邮件 和 移动 问 发 送 通知 来 处 理 这 些 消息 。 

Account 和 Customer 微服 务 包含 目 身 的 H2 数据 库 ， 而 Notification 服务 则 使 用 
MongoDB。 在 当前 应 用 程序 中 ， 我 们 将 采用 Spring Cloud Stream 模块 提供 应 用 程序 中 的 
抽象 消息 机 制 ， 该 框架 用 于 构建 事件 驱动 型 微服 务 应 用 程序 。 


9.5 Spring Cloud Streaming 向 介 


Spring Cloud Stream 框架 用 于 构建 消息 驱动 型 微服 务 应 用 程序 , 并 从 特定 的 消息 代理 
实现 中 将 消息 生产 者 和 使 用 者 代码 抽象 出 来 .Spring Cloud Stream 提供 了 相应 的 输入 和 和 输 
出 通道 ， 并 为 外 部 世界 的 通信 提供 服务 。Spring Cloud Stream 构建 于 Spring Boot 之 上 ， 
并 可 创建 独立 的 和 生产 级 的 应 用 程序 。 另 外 ，Spring Integration 还 提供 了 Spring Cloud 
Stream. 的 消息 代理 连接 机 制 。 通 过 回应 用 程序 代码 中 注入 绑 定 依赖 关系 ， 可 方便 地 添加 
消息 代理 ， 例 如 Kafka 和 RabbitMQ。 

考查 下 列 Spring Cloud Stream 的 Maven 依赖 关系 : 

«dependency» 

«grouplId»org.springframework.cloudc/groupId» 


«artifactlId»spring-cloud-stream-reactive«/artifactld» 


</dependency> 
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上 述 Maven 依赖 关系 添加 了 Spring Cloud Stream 依赖 关系 啊 应 式 模 型 。 下 和 面 查 看 如 
何 司 用 应 用 程序 并 连接 消息 代理 ， 如 下 所 示 : 
aEnableBinding (NotificationStreams.class) 


public class StreamsConfig 1{ 


} 


在 上 述 代 人 码 中 ， 注 解 @EnableBinding H T Jc HMH FETA ERE E, 
注解 使 用 一 个 或 多 个 接口 作为 参数 。 在 当前 示例 中 ， 我 们 传递 了 NotificationStreams Aa 口 
作为 参数 ， 如 下 所 示 : 

public interface NotificationStreams 1 

String INPUT = “notification 1n”s 

String OUTPUT — Tnotificakron out"; 

@Input (INPUT) 

SubscribableChannel subscribe (}; 

Output (OUTPUT) 


MessageChannel notifyTo(); 
} 


可 以 看 出 ,接口 声明 了 输入 和 /或 输出 通道 ， 这 也 是 当前 示例 中 的 目 定 义 接口 。 当 然 ， 
谈 者 还 可 使 用 Spring Cloud Stream 提供 的 Source, Sink 和 Processor xO, HARUN F. 

D Source: 访 接 口 可 用 于 包含 单一 出 站 (outbound) 通道 的 应 用 程序 。 

Q Sink: 蒋 接口 可 用 于 包 侣 单一 入 站 (Cinbound) 2838 E] ZH] EET - 

L] Processor: 该 接口 用 于 包含 入 站 和 出 站 通道 的 应 用 程序 

万 外 ， 注解 @Input 用 于 标识 输入 通道 ， 并 使 用 这 个 标识 符 接收 输入 
到 应 用 程序 的 消息 。 类 似 地 ， 注 解 @Output 用 于 标识 输出 通道 ， 通 过 该 标识 符 ， 发 布 的 
消息 将 离开 当前 应 用 程序 。 

(QInput 和 @Output 注解 及 用 名 称 参 数 作为 明媚 名 ; 如 来 未 提供 设 名 称 ， 那 么 ， 献 认 
状态 下 ， 将 使 用 注解 方法 的 名 称 。 在 当前 应 用 程序 中 ， 我 们 使 用 了 Kafka 作为 消息 代理 ， 
下 面 对 此 加 以 详细 讨论 。 


9.5.1 回应 用 程序 中 沫 加 Kafka 


Apache Kafka 是 一 个 基于 发 布 -订阅 的 高 性 能 、 横 回 伸 缩 的 消 明 传递 平台 ， 其 设计 和 宗 
虽 是 具备 快速 、 可 伸缩 性 和 分 布 式 特征 。Spring Cloud Stream 支持 Kafka 和 RabbitMQ 的 
绑 定 器 实现 。 首 先 ， 需 要 在 机 器 上 安装 Kafka， 下 面 对 此 予以 介绍 。 
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952 安装 和 运行 Kafka 


读者 可 访问 https://kafka.apache.org/downloads 下 载 Kafka， 并 利用 下 列 命令 执行 解压 
PRIF: 


> tar -xzf kafka 2.12-1.1.0.tgz 
> cd kafka 2.12-1.1.0 


下 列 命令 用 于 局 用 ZooKeeper fll Kafka (Windows 环境 下 ) : 


> binNwindowsMzookeeper-server-start.bat configzookeeper.properties 


> binNwindowsNkafka-server-start.bat configserver.properties 


通过 下 列 命令 可 在 Linux 环境 下 局 用 ZooKeeper 和 Kafka: 


> bin/zookeeper-server-start.sh config/zookeeper.properties 


» bin/kafka-server-start.sh config/server.properties 


在 机 器 上 局 用 Kafka 后 ， 下 面 在 应 用 程序 中 添加 Kafka Maven 依赖 天 系 ， 如 下 所 示 : 


«dependency» 

«grouplId»org.springframework.cloud«c/groupId» 
«artifactlId»spring-cloud-stream-binder-kafkac«/artifactId» 
</dependency> 

<dependency> 

<groupId>org.springframework.cloud</groupId> 
«artifactlId»spring-cloud-stream-binder-kafka-streams«/artifactId» 
</dependency> 


不 难 发 现 ， 这 里 添加 了 Spring Cloud Stream 和 Kafka 绑 定 器 。 在 添加 了 上 述 依 赖 关 
系 后 ， 接 下 来 设置 Kafka 的 配置 属性 。 


953 Kafka 配置 属性 


针对 某 个 微服 务 ， 考 查 下 列 application.yml 配置 : 


Spring: 
application: 
name: customer-service 


cloud: 
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stream: 
kafka: 
binder: 
brokers: 
- löcalhost:9097 
bindings: 
nobrfrecation- In: 
destination: notification 
contentType: application/json 
notification-out: 
destination: notification 


contentType: application/json 
该 文件 配置 了 所 连接 的 Kafka 服务 器 地 址 ， 以 及 代码 中 用 于 入 站 和 出 站 数据 流 的 
Kafka 主题 。 其 中 ，contentType 属性 通知 Spring Cloud Stream F KR m P ATIE R 
送 或 接收 消 轧 对 象 。 


9.5.4 用 于 写 入 Kafka 的 服务 


HE FIREX, ZRK EMHI PSA Kafka. 


RServicepublic class NotificationService f{ 
private final NotificationStreams notificationStreams; 


public NotificationService(NotificationStreams notificationStreams) { 
super(); 
this.notificationStreams = notificationStreams; 


} 


public void sendNotification(final Notification notification) { 
MessageChannel messageChannel = notificationStreams.notifyTo(); 
messageChannel.send(MessageBuilder.withPayload (notification) 
.SetHeader (MessageHeaders.CONTENT TYPE, MimeTypeUtils.APPLICATION JSON) 
bi Editi 
} 
} 


在 上 述 服务 类 中 ，sentNotificationO 方 法 使 用 了 一 个 注入 后 的 NotificationStreams 对 
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象 ， 并 发 送 应 用 程序 中 Notification 对 象 所 表示 的 消息 。Controller 类 将 触发 Kafka 的 消息 
发 送行 为 ， 接 下 来 将 对 此 加 以 讨论 。 


95.5 Rest API 控制 器 


EZA Rest Controller 类 时 ， 我 们 将 创建 一 个 REST API 疹 点 ， 访 控制 器 将 利用 
NotificationService Spring Bean 触发 针对 Kafka MYK ERISTA, Wl P Wr: 


QRestController 
public class CustomerConbkroller | 


aAutowired 

CustomerRepository customerRepository; 

aAutowired 

AccountService accountService; 

aAutowired 

NotificationService notificationService; 

aPostMapping (value = "/customer") 

public Customer save (üRequestBody Customer customer)(|[ 
Notification notification = new Notification("Customer is created", 
"adminüdineshonjava.com", "9852XXX122"); 
notificationService.sendNotification (notification); 
return customerRepository.save(customer); 


} 


} 

在 上 述 Customer 服务 的 Controller 类 中 ， 可 以 看 到 该 类 与 NotificationService 则 存在 
依赖 天 系 。 其 中 ，save0 方 法 负 贡 在 对 应 的 数据 库 中 创建 一 个 客户 ; 同时 还 将 利用 
Notification 对 象 生 成 一 条 通知 消息 ， 并 将 其 通过 NotificationService 的 sendNotification() 
方法 发 送 至 Kafka 中 。 接 下 来 考查 Kafka 如 何 通 过 主题 名 通知 监听 该 消息 。 


9.5.6 监听 Kafka 主题 


此 处 将 创建 一 个 监听 器 类 NotificationListener， 监 听 Kafka 通知 主题 上 的 消息 ， 并 癌 
客户 发 送 电 子 邮件 和 SMS 通知 ， 如 下 所 示 : 


aComponent 
public class Notifticationbistener f 
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aStreamListener(NotificationStreams.INPUT) 

public void sendMailNotification(8Payload Notification notification) [1 

System.out.println("Sent notification to email: 

"inotification.getbmai1l()1"Message: "inotificatijion.getMess5aqe(t)):; 

} 

QStreamListener (NotificationSstreams. INPUT) 

public void sendSMSNotification (@Payload Notification notification) { 

System.out.printin ("Notified with SMS Eo mobile: 

"notification. getMobile()+" Message: "+notifiıcation.getMessage()); 

} 

} 

其 中 ，NotificationListener 类 定义 了 两 个 方法 ， 即 sendMailNotification() 和 
sendSMSNotification) 77 14. XIF Kafka 通知 主题 上 的 每 个 新 的 Notification 消息 对 象 ， 
Spring Cloud Stream 将 调用 这 些 方法 。 此 类 方法 采用 @StreamListener 进行 注解 ， 该 注解 
使 得 方法 监听 器 接收 流 处 理 所 需 的 事件 。 

本 章 并 未 列 出 事件 驱动 型 应 用 程序 的 完整 代码 ， 读 者 可 访问 GitHub 获取 全 部 内 容 ， 
对 应 网 址 为 https://github.com/PacktPublishing/Mastering-Spring-Boot-2.0. 

下 和 面 运 行当 前 应 用 程序 ， 并 测 试 事件 驱动 型 应 用 程 夺 的 工作 方式 。 自 先 ， 应 确 你 运 
fT Kafka 和 Zookeeper， 其 中 ，Kafka 服务 器 将 运行 于 http://localhost:9092 E. 

接 下 来 运行 EurekaServer 、ApiZuulService 、AccountService 、 CustomerService 和 
NotificationService。 在 浏览 器 中 开启 Eureka Dashboard 后 ， 对 应 结果 如 图 9.5 所 示 。 
Instances currently registered with Eureka 


Application AMIs . Availability Zones 
ACCOUNT-SERVICE 

API-GATEWAY 

CUSTOMER-SERVICE 


NOTIFICATION-SERVICE —. n/a(í1) 


几 9.5 


不 难 友 现 ， 全 部 服务 均 处 于 运行 状态 。 下 面 创 建 一 个 Customer 对 象 并 触及 Kafka 事 
件 。 此 处 使 用 了 Postman 作为 REST % PF m, KF Postman, $ 11 和 章 将 对 此 加 以 讨论 。 
考 合 图 9.6, 其 中 , dX pi Zuul API Gateway, JH http://localhost:8080/api/customers/ 
customer API 创建 了 一 个 新 的 客户 。 
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http://localhost:8080/api/accounts/account 


Body ® 


form-data x-www-form-urlencoded 9 raw 


"accountld": 280, 
"balance": 33302.23, 
"customerlid" : 2001, 
"account[Iype": "SAVING", 
"branchCode": "HDFCIl18", 
"bank": "HDFC" 


"accountlid": 200, 
"balance": 33302.23, 
"customerlid": 2001, 
"account[ype": "SAVING", 
"branchCode"; "HDFC118", 
"bank": "HDFC" 


图 9.6 
这 里 ， 我 们 在 数据 库 中 输入 了 一 个 新 的 客户 记录 。 如 前 所 述 ， 当 创建 新 客户 时 ， 将 
针对 Kafka 触发 一 条 消息 ， 并 利用 Notification 微服 务 发 送 电子 邮件 和 SMS 通知 。 图 9.7 
显示 了 Notification 微服 务 的 控制 台 输 出 结果 。 


Œ Console 53 mj Progress le) Problems ‘ Search 


Chapter-09-notification-service - NotificationServiceApplication [Spring Boot App] CProgram Files\Java\jre1.8.0_161\bin\javaw.exe 


Sent notification to email: adminGdineshonjava.com Message: Account is created 
Notified with SMS to mobile: 9852XXX122 Message: Account is created 


图 9.7 


利用 Customer 服务 ， 我 们 创建 了 一 个 新 客户 ， 这 将 触发 一 条 通知 ， 并 通过 Kafka fU 
理发 送 至 当前 客户 。 显 然 ， 这 是 一 个 消息 驱动 型 异步 调用 。 

类 似 地 ， 当 针对 新 客户 创建 一 条 账户 记录 时 ，Kafka 将 针对 账户 的 创建 监听 另 一 条 新 
的 通知 消 轧 ， 对 应 结果 如 图 9.8 所 示 。 

图 9.9 显示 了 Notification 微服 务 的 控制 合 输出 结果 。 


* 180 ° 精通 Spring Boot 2.0 


m am 


http://localhost:S080/api/customers/customer 


- m 
x-www-form-urlencoded " 


"customerId": 2001, 
"customerName": "Rushika Rajput", 
"mobile": "94312XX223", 

"email": "rushikaxxxg&mail.com", 
"city": "Noida" 


"customerlid": 2001, 
"customerName": "Rushika Rajput", 
"mobile": "94312XX223", 

"email": "rushikaxxxgmail.com", 
"city": "Noida", 

"account": null 


图 9.8 


Œ Console zi | SH Progress |*; Problems $ Search 


Chapter-ÜS9-notification-service - NotificationServiceApplication [Spring Boot App] C:\Program FilesJavayre1.2.0 Tolibinjavaw.exe 


Sent notification to email: admin8dineshonjava.com Message: Customer is created 
Notified with 5M5 to mobile: 98522424122 Message: Customer is created 


图 9.9 


其 中 针对 当前 客户 创建 了 一 个 账户 ， 并 触及 了 针对 Kafka HJ—2&3B c. E RI LA BU 
%2 P RISET AMEMA SMS 消息 。 当 访问 http://localhost:8080/api/customers/customer/2001 
时 ， 图 9.10 显示 了 生成 客户 后 的 客户 记录 。 

可 以 看 到 , 当前 客户 拥有 完整 的 信息 , 包括 所 关联 的 账户 对 象 , 人 至此, 本 章 通 过 Spring 
Cloud Stream. Kafka Event Bus. Spring Netflix Zuul 以 及 Spring Discovery Service 构建 了 事 
件 驱 动 型 微服 务 ， 读 者 可 访问 https://github.com/PacktPublishing/Mastering-Spring-Boot-2.0 
获取 GitHub 存储 库 中 完整 的 示例 代码 。 
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g |ocalhost8080/api/custo X W — Y 


= © |Q) localhost8080/api/customers/customer/2001 


customerId: 2001, 
customerName: "Rushika Rajput", 
mobile: "94312XX223", 
email: "rushikaxxx(lmail.com", 
city: "Noida , 

- account: [ 


accountlId: 200, 
balance: 33302.23, 
customerId: 2001, 
accountType: "SAVING", 
branchCode: "HDFC1180", 
bank: "HDFC" 


图 9.10 
9.6 本 草 小 结 


本 章 讨 论 了 事件 驱动 、 命 令 查 询 职 贡 分 离 、 事 件 源 以 及 最 终 一 致 性 等 设计 模式 。 其 
|H], Spring Cloud Stream 馆 过 为 一 种 方式 并 基于 事件 驱动 和 消 明 驱动 创建 了 分 布 式 应 用 
程序 。 

对 于 包含 多 项 微服 务 的 事件 驱动 型 架构 ， 本 章 在 此 基础 上 构建 了 一 个 系统 ， 其 中 利 
用 Kafka (FÑ EAR) 和 Spring Cloud Stream， 作 为 对 Kafka 和 RabbitMQ 绑 定 器 的 
支持 。 最 后 本 章 通过 Kafka 实现 了 一 个 事件 驱动 型 系统 。 

第 10 章 将 通过 对 Hystrix 和 Turbine 的 讨论 来 实现 一 个 弹性 系统 。 
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本 章 将 通过 基于 Netflix Hystrix 库 的 参考 实现 讨论 断路 右 模 式 , 同 时 还 将 配置 Turbine 
仪表 盘 ， 并 从 多 项 服务 中 整合 Hystrix 数据 流 。 此 外 ， 我 们 还 将 介绍 与 Turbine 仪表 盘 相 
关 的 某 些 重要 概念 ， 进 而 从 多 项 服务 中 整合 数据 流 。 

如 前 所 述 ， — jemand mtt 日 各 部 
分 内 容 作 为 独立 服务 予以 部 罩 。 这 一 系统 也 称 作 分 布 式 系统 ， 且 包含 了 诸多 优点 ， 第 4 

章 曾 对 此 有 上 所 讨论 。 redder 邓 的 分 布 特征 ， 与 单 体 应 用 程序 相 比 ， 其 间 也 包 
含 了 更 多 的 潜在 故障 模式 。 随 着 服务 数量 在 分 布 式 系统 中 的 不 断 增 加 ， 出 现 连 锁 故 障 的 
几率 也 就 越 大 。 

由 于 每 个 传 入 的 请 求 将 会 面临 数 十 个 甚至 数 百 个 不 同 的 微服 务 ， 因 此 ， 依 赖 项 中 的 
某 些 故障 实际 上 难以 避免 。 关 于 容错 机 制 ， 曾 有 以 下 名 言 : 

“如 果 未 采用 任何 措施 以 确保 容错 , 那么 , 30 个 依赖 项 (其中, 每 个 依赖 项 具有 99.9996 
的 正常 运行 时 间 ) 将 会 导致 至 少 两 个 小 时 的 停机 时 间 (99.99%30=99.7% 正 第 运行 时 间 =2+ 
每 月 小 时 数 ) ”。 


Ben Christensen, Netflix 工程 师 


本 章 将 介绍 一 种 模式 ， 以 防止 微服 务 中 的 连锁 故障 ， 从 而 消除 分 布 式 系统 中 的 无 效 
服务 。 

在 阅读 完 本 草 后 ， 读 者 将 能 够 更 好 地 理解 容错 机 制 、 断 路 二 模 式 、 如 何 采 用 Netflix 
Hystrix 库 防止 分 布 式 系 统 中 的 连锁 故障 ， 以 及 如 何 启 用 Hystrix 和 Turbine 仪表 盘 进 而 对 
故障 进行 监视 。 

本 章 主要 涉及 以 下 主题 : 

Q Bre. 
通过 参考 实现 使 用 Hystrix FE. 

H EXAM E. o 

Hystrix Metrics Stream. 

Hystrix Dashboard. 

Turbine Dashboard. 

基于 Hystrix 和 Feign 的 REST 使 用 者 。 


LDLDLLLL 
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10.1 断路 器 模式 


在 分 布 式 软 件 系 统 中 ， 较 为 常见 的 情形 是 ， 利 用 网 络 间 的 不 同 环境 ， 针 对 运行 在 不 
同 机 器 设备 上 的 服务 执行 远程 调 有 用。 其间， 客户 问 过载 可 能 会 导致 远程 调用 失败 ， 并 在 
达到 超时 限制 之 前 没有 任何 啊 应 ， 这 对 于 分 布 式 系统 来 说 是 一 类 较为 严重 的 问题 。 在 单 
体 结 构 中 ， 在 应 用 程序 外 部 调用 远程 服务 并 不 十 分 常见 ， 通 常 是 内 存 调用 。 这 也 是 内 存 
调用 和 远程 调用 之 间 较 为 显著 的 不 同 ， 而 远程 调用 有 时 会 产生 故障 。 

断路 器 模式 可 防止 在 分 布 式 软件 系统 中 出 现 此 类 故障 。 断 路 器 模式 背后 的 理念 十 分 
简单 : 只 需 为 远程 函数 调用 创建 一 个 断路 器 对 象 ， 用 于 监视 分 布 式 软件 系统 中 的 级 联 故 
障 。 其 中 ， 每 个 断路 器 包含 一 个 故障 靖 值 ， 一 旦 到 达 该 闪 值 ， 断 路 器 即 会 在 系统 中 开局 。 
所 有 对 断路 器 的 进一步 调用 都 会 返回 一 个 错误 、 一 个 空 对 象 或 硬 编码 值 ， 而 根本 不 会 执 


行 受 你 护 的 碳 用 。 
新 路 喜 可 防止 系统 中 不 断 产 生 的 故障 。 设 计 模 式 为 开 肥 人 员 在 软件 编程 过 程 中 重复 


出 现 的 问题 、 任 务 和 Bug 提供 另外 相应 的 解决 方案 。 当 接触 到 错误 的 方法 调用 的 边缘 时 ， 
断路 器 模式 将 开局 通路 。 特 征 匹 配 是 利用 拦截 占 测 算 执 行 结果 并 显示 异常 ， 在 达到 极限 
后 ， 拦 戳 问 返回 时 将 不 会 调用 当前 目标 。 

图 10.1 显示 了 一 个 分 布 式 软件 系统 。 

在 图 10.1 中 ， 使 用 者 将 通过 断路 器 调用 生产 者 服务 。 同 时 ， 该 断路 器 还 将 对 故障 进 

行 监 视 。 如 果 系 统 中 产生 了 任何 与 网 络 故 障 相 关 的 问题 ， 系 统 将 由 于 过 载 〈 即 超时 ) 而 
itat. res uS PA NASA. — H S03 d Es B TEC zs DJ AE XE BLEU HAS EAT 
布 式 软件 系统 中 ， 断 路 器 可 在 不 调用 生产 者 生成 的 远程 服务 的 情况 下 打开 并 服务 于 请 求 。 

虽然 超时 行为 限制 了 框架 资源 数据 的 使 用 ， 但 断路 器 则 更 加 有 用 。 电 子 开关 可 以 识 

Wap 
这 种 设计 模式 倾 问 于 消除 重复 出 现 的 错误 。 

我 们 可 以 使 用 断路 器 设计 模式 将 客户 疹 数 据 资源 从 任何 注定 会 失败 的 调用 中 节省 出 
来 ， 同 时 还 可 以 节省 服务 器 端的 数据 资源 。 如 果 服 务 器 处 于 错误 状态 ， 如 过 载 状态 ， 在 
服务 器 闯 添 加 额外 的 扒 并 不 是 一 个 明智 之 举 。 

断路 器 模式 旨 在 生成 安全 的 工作 调用 。 根 据 当 前 状态 ， 相 关 调 用 将 被 拒绝 或 执行 。 
作为 一 项 规则 ， 上 断路 器 实现 了 以 下 3 种 状态 : 

口 ”“ 关 闭 状态 。 

2 ”开局 状态 。 
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四” 半 开 忆 状态 。 


-一 


E 


人 , 环 路 打开 


图 10.1 
色 10.2 显示 了 断路 井 的 状态 示意 


图 10.2 


5 IB 
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对 于 全 部 成 功 的 远程 调用 ， 或 者 处 于 国 值 之 下 的 故障 ， 上 断路 乾 将 处 于 关闭 状态 。 硬 
故障 超出 了 极限 ， 断 路 器 即 会 开 司 。 随 后 ， 断 路 器 将 会 重 置 超时 ， 并 转换 为 半 开 局 状态 ， 
HE RI AC H. 

在 关闭 状态 下 ， 事 务 及 其 度量 结果 将 被 保存 ， 且 调用 也 将 被 执行 。 其 中 ， 度 量 绪 果 
十 分 重要 ， 且 多 与 系统 的 健康 状态 相关 。 如 果 系 统 的 健康 状态 受到 影响 ， 上 断路 器 将 不 再 
处 于 开局 状态 。 其 中 ， 大 多 数 调 用 将 被 驳回 ， 开 司 状 态 背 后 的 思想 是 赋予 服务 问 端 更 多 
的 时 间 以 处 理 相 关 问 题 。 

当 上 断路 硕 进 入 打开 状态 时 ， 超 时 时 钟 将 被 局 用 。 如 条 访 时 钟 出 现 故 障 ， 那 么 电子 开 
关 将 变 为 半 开 局 状态 。 在 半 开 局 状态 下 ， 大 多 数 调 用 偶尔 会 执行 一 次 ， 以 检查 问题 是 否 
己 被 处 理 。 假 设 一 切 工 作 正 营 ， 此 时 当前 状态 返回 至 关闭 状态 。 

断路 器 通道 采用 了 “执行 前 ”策略 和 “执行 后 ”两 种 策略 。 在 “执行 前 ”策略 中 ， 
系统 将 验证 是 否 允 许 执行 相关 请 求 。 相 应 地 ， 针 对 每 个 目标 主机 将 使 用 一 个 专用 的 断路 
器 ， 以 记录 最 终 的 目标 。 咎 调用 被 允许 ， 则 需 维 护 HITP 交换 以 持 有 上 度量 绪 果 。 通 过 将 
输出 结果 指定 于 交换 内 容 中 ， 在 “执行 后 ”策略 中 ， 交 换 度 量 结 果 问 题 将 被 关闭 。5xx 
状态 啊 应 将 被 转换 为 一 条 错误 信息 。 

同样 ， 上 断路 器 示例 也 可 在 服务 器 端 执 行 。 这 里 ， 服 务 器 端 通道 的 范围 是 目标 任务 ， 
而 不 是 目标 主机 。 如 果 筹 备 完 毕 的 目标 任务 中 涵盖 了 错误 ， 那 么 ， 调 用 将 立刻 被 驭 回 ， 
同时 还 包含 了 对 应 的 错误 状态 。 使 用 服务 器 端 通道 可 确保 错误 操作 不 会 被 允许 消耗 过 多 

Pr fr Spring Cloud 如 何 支 持 这 一 断路 器 模式 ， 也 就 是 说 ， 在 分 布 式微 服务 中 
使 用 Netflix Hystrix 作为 默认 的 容错 机 制 。 


10.2 使 用 Hystrix library 


Spring Cloud 文 持 Netflix 工具 。Netflix 开发 了 一 个 基于 靳 路费 模式 实现 的 库 ， 名 为 
Hystrix。 在 微服 务 架 构 中 ， 可 利用 Hystrix 库 防 止 连锁 故障 ， 因 为 在 微服 务 体系 结构 中 ， 
跨 网 络 且 在 不 同 的 机 器 上 承载 多 个 独立 服务 是 非常 单 见 的 。 基 于 微服 务 的 系统 包含 多 个 
服务 调用 层 。 

在 微服 务 架 构 中 , 分 布 式 系统 的 连锁 故障 可 导致 底层 服务 故障 。 因 此 , Netflix Hystrix 
提供 了 一 种 方式 可 防止 系统 整体 出 现 故 障 ， 即 使 用 回 退 调用 ; 同时， 开发 人 员 可 提供 一 
个 回 退 。 另 外 ， 每 个 断路 器 均 包 含 自 身 的 故障 赋值 。 在 Hystrix 中 ， 如 果 在 一 个 由 
metrics.rollingStats.timeInMilliseconds (默认 为 10 秒 ) 定义 的 行程 中 ， 特 定 服务 调 用 的 次 
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数 超出 了 circuitBreaker.requestVolumeThreshold (默认 时 为 20 个 请 求 ) ， 且 故障 的 百 分 
tE K F metrics.rollingStats.timeInMilliseconds (默认 为 10 秒 ) 定义 的 circuitBreaker. 
errorThresholdPercentage (默认 大 于 5096) ， 则 会 开启 Hystrix， 且 调用 对 于 当前 特定 服务 
Fre 
图 10.3 显示 了 Hystrix 回 退 如 何 防 止 连锁 故障 。 


服务 服务 服务 服务 
消费 者 | | 消费 者 | | 消费 者 | | 消费 者 


API 


图 10.3 


Hystrix 回 退 可 有 效 地 防止 分 布 式 系统 中 的 连锁 故障 ， 这 其 中 会 涉及 多 个 服务 ， 如 服 
务 A、 服 务 B、 服 务 C、 服 务 D 和 服务 E。 服 务 使 用 者 通过 API 网 关 调 用 此 类 远程 服务 ， 
但 任何 特定 的 服务 故障 均 可 导致 系统 出 现 故 障 。 开 放 的 通路 可 以 防止 系统 的 整体 故障 ， 
并 留 出 一 定 的 时 间 对 该 故障 服务 进行 修复 。 相 应 地 ， 开 发 人 员 负 责 提 供 这 一 回 退 ， 它 可 
以 是 另 一 个 受 Hystrix 保护 的 调用 、 空 对 象 或 一 些 静 态 数据 。 另 外 ， 开 发 人 员 还 可 定义 一 
个 回 退 链 ， 以 生成 一 个 业务 任务 调用 ， 并 将 另 一 个 回 退 转换 为 静态 数据 或 空 业务 对 象 ， 
这 完全 取决 于 具体 的 业务 需求 。 

接 下 来 考查 如 何在 应 用 程序 中 引入 和 配置 Hystrix- 


10.3 Æ MA Y Be E Hystrix 


本 节 将 在 前 述 示例 的 基础 上 讨论 Spring Cloud Netflix Hystix， 并 实现 断路 器 模式 ,我 
们 将 制定 一 种 策略 ， 进 而 有 效 地 防止 分 布 式 系统 中 底层 服务 的 连锁 故障 。 前 先 ， 将 在 
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Customer 和 Account 微服 务 应 用 程序 中 配置 Hystrix, HARUN F - 

D ”Account 微服 务 :该 微服 务 将 问 Account 实体 生成 一 些 基 本 的 功能 ,并 从 Customer 
服务 中 调用 该 Account 服务 ， 以 理解 断路 器 模式 。Account 微服 务 将 运行 于 本 地 
主机 的 6060 端口 上 。 

L] Customer 微服 务 : 基于 REST 的 微服 务 , 其 中 采用 Hystrix SEIL f Wreg gs» Account 
微服 务 将 从 Customer 微服 务 中 被 调用 ， 一 旦 Account 服务 不 可 用 ， 我 们 将 会 看 
到 相应 的 回 退路 径 。Customer 微服 务 将 运行 于 本 地 主机 的 6161 9m OE- 

Hystrix 将 监视 调用 远程 服务 的 一 些 方法 ， 以 防止 调用 失败 。 如 果 存 在 某 种 故障 ， 则 

会 开启 通路 ， 并 将 调用 转发 给 一 个 回 退 方法 。Hystrix 库 支 持 针对 某 个 羡 值 的 容错 机 制 ， 
当 到 达 立 值 时 ， 将 开启 断路 器 ， 并 将 所 有 后 续 调 用 转发 至 对 应 的 回 退 方法 ， 以 防止 系统 
整体 出 现 故 障 ; 同时 还 为 故障 服务 预 留 一 定时 间 ， 以 便 从 故障 状态 恢复 到 健康 状态 。 


10.3.1 Maven 依赖 关系 


相应 地 ,可 利用 org.springframework.cloud 分 组 和 spring-cloudstarter-netflix-hystrix 7s 
加 starter， 以 便 在 应 用 程序 中 包含 Hystrix. 4A pom.xml 文件 中 的 下 列 Maven 依赖 天 系 : 


<dependency> 
<grouplId>org.springframework.cloud</grouplId> 
«artifactId»spring-cloud-starter-netflix-hystrix«/artifactId» 
</dependency> 


器 当前 项 目 中 加 入 上 述 Maven 依赖 关系 将 包含 Hystrix FE. 
10.3.2 局 用 断路 器 


器 main 配置 应 用 程序 中 添加 @EnableCircuitBreaker 注解 ， 将 司 用 应 用 程序 中 的 断路 
fro AA PIRIS: 


package com.dineshonjava.customerservice; 


import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootApplication; 
import 
org.springframework.cloud.client.circuitbreaker.EnableCircuitBreaker; 
import org.springframework.cloud.client.loadbalancer.LoadBalancedg; 
import org.springframework.cloud.netflix.eureka.EnableEurekaClient; 


import org.springframework.context.annotation.Bean; 
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import org.springframework.web.client.RestTemplate; 


aSpringBootApplication 
aEnableEurekaClient 


EnableCircuitBreaker 


public class CustomerServiceApplication 1 


public static void main(String[] args) f 


} 


SpringApplication.run (CustomerServiceApplicatıion.class, args); 


这 里 使 用 了 @EnableCircuitBreaker Eft Ja HJ HIERHER BEER RS $E FR Ve a 
回应 用 程序 的 服务 层 中 添加 Hystrix 功能 。 


10.3.3 ”向 服务 中 添加 Hystrix 注解 


Netflix Hystrix 提供 了 一 个 @HystrixCommand 注解 并 可 用 于 服务 层 , 进而 加 入 断路 器 
便 式 中 的 相关 功能 。 考 得 下 列 代码 : 


package com.dineshonjava.customerservice.service; 


import 


import 


import 
import 
import 


import 


import 


import 


java-ubkri-ArraybrsE; 


java-üutrlt.:bist; 


Org. 
org- 
Org. 


Org- 


com. 


com 


Service 


springframework.beans.factory.annotation.Autowired; 
springframework.cloud.client.loadbalancer.LoadBalancedg; 
springframework.stereotype.Service; 


springframework.web.client.RestTemplate; 


dineshonjava.customerservice.domain.Account; 


.nettli:x.hystrix.contrib.]javanica.annotation.Hystr1xCommand; 


public class AccountServicelmpl implements AccountService 1{ 


aQAutowired 

aLoadBalanced 

RestTemplate restTemplate; 
QGHystrixCommand(fallbackMethod = "defaultAccount") 
public List«Account» findByCutomer(Integer customer) { 
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//do stuff that might fail 
return restTemplate.getForObject ("http://ACCOUNTSERVICE/ 


account/customer/í([customer]", List.class, customer); 


public ListcAccount- defaultAccount() | 
/* something useful */; 
return new ArrayListc^(); 
) 
} 

此 处 在 findByCutomer(Integer customer) /7 1: Bj 48H]. f @HystrixCommand(fallbackMethod = 
"defaultAccount")7X fff. fallbackMethod 属性 表示 为 针对 回 退 条 件 的 defaultAccountQ 77 X . 
该 回 退 方法 可 包含 任意 访问 标识 符 。 如 前 所 述 ，Netflix 针对 容错 机 制 通 过 了 强大 的 库 ， 
Hystrix H] CEA BL TEWTER dH Un. MEINTE HystrixCommand 对 象 中 。 

Spring Cloud 为 那些 采用 @HystrixCommand 注解 的 Spring Bean 创建 一 个 代理 , 同时 ， 
这 一 代理 将 连接 至 Hystrix 断路 器 上 。 相 应 地 ， 这 一 断路 器 将 监视 何 时 开局、 关闭 通路 ， 
并 对 故障 采取 相应 的 策略 以 执行 相关 操作 。 男 外 ， 还 可 以 使 用 高 有 @HystrixProperty 注解 
列表 的 commandProperties 属性 ， 进 而 配置 @HystrixCommand。 

需要 注意 的 是 ，Hystrix 命令 和 回 退 应 置 于 相同 的 类 中 ， 并 包含 相同 的 方法 签名 ( 针 
对 故障 执行 开 名 的 可 选 参数 ) 。 

之 前 声明 的 defaultAccount 方法 将 用 于 处 理 错误 发 生 后 的 回 退 逻辑 。 如 果 需 要 作为 单 
独 的 Hystrix 命令 运行 defaultAccount 回 退 方法 , 则 需要 利用 HystrixCommand 对 其 进行 注 
解 ， 如 下 所 示 : 

aHystrixCommand(fallbackMethod = "defaultAccount") 

public Account getAccountById(String id) { 


return accountService.getAccountById (id); 


} 


aHystrixCommand 
private Account defaultAccount(String id) { 
return new Account(i); 


} 

可 以 看 到 ， 我 们 通过 @HystrixCommand 标记 了 一 个 回 退 方法 ; 当前 ，defaultAccount 
回 退 方法 还 包含 了 男 一 个 回 退 方法 ， 如 下 所 示 : 

aHystrixCommand(fallbackMethod = "defaultAccount") 


public Account getAccountById(String id) { 


return accountService.getAccountById (id); 
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aHystrixCommand(fallbackMethod - "defaultUserSecond") 
private Account defaultAccount (String sd) 1 
return new Accounti); 
} 
aHystrixCommand 
private Account defaultAccountSecond(String id) { 
return new Account t 1002". As 


} 


此 处 ， 我 们 声明 了 defaultAccountSecond 回 退 方法 ， 并 作为 第 一 个 defaultAccount [nl 
退 方 法 的 回 退 方法 。 
Hystrix 库 还 可 传递 额外 的 参数 ， 以 便 获 取 某 个 命令 抛 出 的 异 第 。 考 但 下 列 代码 示例 : 


aHystrixCommand(fallbackMethod = "fallbackl") 
public Account getAccountById(String id) { 


throw new RuntimeException("getAccountById command raised error"); 


aHystrixCommand(fallbackMethod - "fallback2") 
Account fallbackl(String id, Throwable e) { 


throw new RuntimeException("fallbackl raised error"); 


aHystrixCommand(fallbackMethod - "fallback3") 
Account fallbackZi5tring zd) 1| 


throw new RuntimeException("fallback2 raised error"); 


aHystrixCommand(fallbackMethod - "staticFallback") 
Account fallback3 (String id, Throwable e) | 


throw new RuntimeException("fallback3 raised error"); 


Account emptyObjectFallback(String id, Throwable e) [( 
return new Account(í); 
} 
上 述 代 码 包含 了 多 个 回 退 方 法 , 其 中 包含 了 Throwable 类 型 的 附加 参数 ; 每 个 回 退 均 
通过 附加 的 Throwable 参数 包 侣 了 目 且 的 回 退 方法 ,并 将 命令 开 币 传递 至 fallback 方法 中 。 
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10.3.4 ”错误 传递 


(QHystrixCommand YEH n] H] T 48 XE Pr IP] ERA, WI Hr: 

aHystrixCommand(ignoreExceptions = [BadRequestException.class]) 

public Account findAccountById(String id) { 

return accountService.findAccountById (1d); 

} 

如 果 accountService.findAccountById(id) 抛 出 一 个 BadRequestException KÆ HJE , 
那么 ， 该 异常 将 被 封装 至 HystrixBadRequestException， 并 在 不 引发 回 退 逻辑 的 基础 上 被 
TU d e 

下 面 答 试 针对 customer 服务 创建 REST fils o 


10.4 在 客户 服务 中 实现 REST 控制 器 


本 节 尝 试 针 对 Customer 微服 务实 现 一 个 CustomerController REST 控制 器 ， 并 针对 
CRUD 操作 公开 基 些 疹 点 。/customer{fcustomerId} 端点 简单 地 返回 既定 客户 ID 的 详细 信 
思 ， 以 及 所 关联 的 account 细节 内 容 。 对 于 account 的 详细 内 容 ， 这 将 调用 已 设 定 完毕 并 通 
过 主机 和 端口 扎 部 车 的 另 一 个 微服 务 ， 并 公开 某 些 端点 ， 如 /accountcustomer{fcustomer} 。 
考查 下 列 REST 控制 器 类 : 


package com.dineshonjava.customerservice.controller; 


import java.util.Arrayhrst; 


import javad-utri-Lrst; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.web.bind.annotation.DeleteMapping; 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.PathVariable; 
import org.springframework.web.bind.annotation.PostMapping; 
import org.springframework.web.bind.annotation.PutMapping; 
import org.springframework.web.bind.annotation.RequestBody; 


import org.springframework.web.bind.annotation.RestController; 


import com.dineshonjava.customerservice.domain.Customer; 


import com.dineshonjava.customerservice.repository.CustomerRepository; 
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import com.dineshonjava.customerservice.service.AccountService; 


aRestController 
public class CustomerController { 
aQGAutowired 
CustomerRepository customerRepository; 
aAutowired 
AccountService accountService; 
QGPostMapping (value = "/customer") 
public Customer save (RequestBody Customer customer) { 
return customerhRepository.save(customer); 
} 
@GetMapping (value = "/customer") 
public Iterable<Customer> all (){ 
List<Customer> customers = new ArrayList<>();} 
For (Customer customer : customerRepository.findAll({})){ 
customer.setAccount (accountService.findByCutomer (customer .getCustomerId())); 
} 
return customers; 
} 
@GetMapping (value = "/customer/ícustomerId]") 
public Customer findByAccountId (GPathVariable Integer customeriId){ 
Customer customer -customerRepository.findByCustomerId (customerId); 
customer.setAccount (accountService.findByCutomer (customerId)); 
return customer; 
} 
@PutMapping (value = "/customer") 
public Customer update (@RequestBody Customer customer) { 
return customerRepository.save (customer); 
} 
@DeleteMapping (value = "/customer") 
public void delete (@RequestBody Customer customer) { 


customerRepository.delete(customer); 


} 


不 难 发 现 ， 其 中 注入 了 两 个 属性 ， 即 AccountService 和 CustomerRepository. E, 
CustomerRepository 用 于 访问 客户 数据 ;，AccountService 则 是 一 个 Account 微服 务 的 委托 服 
务 。 下 和 面 考 个 如何 创建 一 个 AccountService.java 委托 层 ， 并 调用 Account 服务 ， 如 下 所 示 : 


package com.dineshonjava.customerservice.service; 


import jgva-utirl.Arraybhist; 
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4. 


4j 


import java-.ubrl-h£fsi; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.cloud.client.loadbalancer.LoadBalanceg; 
import org.springframework.stereotype.Service; 


import org.springframework.web.client.RestTemplate; 


import com.dineshonjava.customerservice.domain.Account; 


import com.netílix.hystrix.contrib.]javanica.annotation.HystrixCommand; 


Service 
public class AccountServicelmpl implements AccountService [( 
aQAutowired 
aLoadBalanced 
RestTemplate restTemplate; 
aGHystrixCommand(fallbackMethod = "defaultAccount") 
public List«Account» findByCutomer(Integer customer) { 
return restTemplate.getForObject ("http://ACCOUNT-SERVICE/account / 
customer/í(customer]", List.class, customer); 
} 
private List«Account» defaultAccount(Integer customer) { 
List«Account» defaultList = new ArrayListc»(); 
defaultList.add(new Account (0000, 1.000, 0000, "UNKNOWN ACCOUNT 
TYPE”; "UNAM", “EALLBACK BANE'") 1; 
return defaultList; 


} 
在 AccountService 代码 中 ， 执 行 了 下 列 步 骤 以 开局 Hystrix WERKS: 

(1) Account 微服 务 巡 过 RestTemplate 提供 的 Spring Framework 被 调用 。 

(2) 使 用 @HystrixCommand(fallbackMethod = "defaultAccount")73:E25J] Hystrix 命 
并 局 用 一 个 回 退 方 法 ; 此 处 需要 添加 另 一 个 defaultAccount 方法 ， 该 方法 的 签名 与 命 


法 findByCutomer(Integer customer) 的 签名 相同 , 并 在 实际 的 Account 服务 关闭 时 被 


调用 。 


务 ， 


(3) 添加 defaultAccount(Integer customer) 回 退 方法 ， 这 将 返回 一 个 默认 值 。 
基于 Hystrix 的 Customer 做 服务 将 使 用 到 采用 Eureka 注册 服务 注册 的 Account 做 服 
这 一 REST 账户 服务 与 前 述 章节 中 所 创建 的 内 容 相 同 ， 访 者 可 访问 GitHub 获取 完整 


的 示例 代码 ， 对 应 网 址 为 https://github.com/PacktPublishing/Mastering-Spring Boot-2.0. 


接 下 来 将 对 customer 服务 进行 构建 和 测试 。 
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10.5 构建 和 测试 客户 服务 


下 面 利 用 mvn clean install 命令 构建 Eureka 服务 器 、Customer 和 Account 服务 ， 并 于 
随后 通过 Java 命令 运行 全 部 服务 。 其 中 ，Customer 服务 位 于 6161 9m L1.E,. Account 服务 
则 位 于 6060 疹 口 上 上。 但 此 处 将 使 用 到 Spring Cloud Eureka 注册 服务 器 ， 因 而 无 纳 通过 实 
际 的 主机 名 和 背 口 调用 Customer 服务 中 的 Account 服务 。 也 束 是 说 ， 仅 使 用 逻辑 服务 名 

(http:/ACCOUNT-SERVICE) 后 可 。 

打开 浏览 器 并 输入 http:wlocalhost:616lcustomer'1001， 进 而 获取 Customer 服务 ， 对 

应 输出 结 来 如 图 10.4 Prz 


g 192.168.225.208:6161/c. XE w 


= G 192.168.225.208:6161/customer/1001 
i 
customerId: 10081, 
customerName: "Arnav Rajput", 
mobile: "54312XX223", 
email: "arnavxxx(imail.com", 
city: "Noida", 
- account: [ 


accountId: 1601, 
balance: 3502.92, 
customerId: 16061, 


accountType: "SAVING", 
branchCode: "ICICIOGO1", 
bank: "ICICI" 


accountId: 200, 
balance: 3122.05, 
customerId: 160601, 
accountType: ^ CURRENT , 
branchCode: "HDFC882", 
bank: "HDFC" 


图 10.4 
在 图 10.4 中 ， 持 有 1001 客户 ID 的 客户 通过 两 个 账户 予以 显示 ， 即 通过 customer 服 
务 于 内 部 调用 Account 服务 。 因 此 ， 如 果 两 个 服务 均 运 行 正常 ，customer 服务 将 显示 
Account 服务 所 返回 的 数据 ， 这 意味 着 ， 上 断路 堪 当 前 处 于 CLOSED 状态 。 下 面 通过 关 厂 
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Account 服务 对 Hystrix 断路 器 进行 测试 。 在 关闭 后 ，Account 服务 和 刷新 后 的 URI 端点 
位 于 http://localhost:616/customer /1001 处 。 
利用 给 定 的 URI 刷新 浏览 器 后 ， 对 应 输出 结果 如 图 10.5 所 示 。 
gj 192.168.225.208:6161/c. x WS 
€ Œ | © 192.168.225.208:6161/customer/1001 


1 

customerId: 16001, 

customerName: Arnav Rajput”, 

mobile: "54312XX223", 

email: "arnavxxxügmail.com", 

city: "Noida", 

- account: [ 
"E 

accountId: O, 
balance: 1, 
customerId: ©, 
accountType: "UNKNOWN ACCOUNT TYPE", 
branchCode: "UNK", 
bank: "FALLBACK BANK" 


图 10.5 


此 时 将 返回 当前 回 退 方法 的 啊 应 结果 。 其 间 ，Hystrix 较为 频繁 地 监视 Account 服务 ; 
当 关 闭 该 服务 时 ，Hystrix 组 件 将 打开 通路 并 启用 回 退 路 径 。 

下 面 再 次 司 动 Account 服务 。 经 几 次 操作 后 ， 将 返回 至 customer 服务 ; 再 次 刷新 浏 
Jude. XUL HI EUER STET Die P MI MMA E o 

接 下 来 将 考查 如 何 通 过 Hystrix 库 自 定义 默认 的 配置 项 。 


10.6“ 自 定义 默认 的 配置 项 


Hystrix 文 持 默认 配置 的 目 定义 操作 ， 即 针对 命令 和 回 退 使 用 茶 些 相关 属性 。 其 中 ， 
命令 属性 可 采用 @HystrixCommand 注解 的 commandProperties 加 以 设置 ， 如 下 所 示 : 


aHystrixCommand(commandProperties = { 

GHystrixProperty (name = 
"execution.isolation.thread.timeoutiInMilliseconds", value = "300") 
j ) 
public Account findAccountByld(String id) 1| 
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return accountService.findAccountByld (id); 


} 


上 述 代 码 将 默认 的 超时 时 间 和 定义 为 300 Z. 5; commandProperties 类 似 ， 还 可 通过 
(QHystrixCommand 的 threadPoolProperties 目 定 义 线 程 池 属 性 ， 如 下 所 示 : 


aHystrixCommand(commandProperties = { 
aHystrixProperty(name - 
"execution.i1solation.thread.timeoutiInMilliseconds", value = "300") 
- 
threadPoolProperties = 1 


aHystrixProperty(name = "coreSize", value = "30"), 
aHystrixProperty(name = "maxQueueSize", value = "101"), 
aHystrixProperty(name = "keepAliveTimeMinutes", value = "2"), 
aHystrixProperty(name = "queueSizeRejectionThreshold", value = 
"Ium. 

aHystrixProperty(name = "metrics.rollingStats.numBuckets", 
yale = "LU. 

aHystrixProperty(name = "metrics.rollingStats. 
bEimelnMilliseconds", value — "1200") 


)) 
public Account frindAccountByrId(S5tring id) | 
return accountService.findAccountById (id); 
} 
此 处 设置 了 了 threadPoolProperties， 如 coreSize, maxQueueSize. keepAliveTimeMinutes 
和 queueSizeRejectionThreshold。 某 些 时 候 , 我 们 需要 针对 所 有 的 Hystrix 命令 设置 一 些 公 
共 属 性 。 此 外 , Hystrix 库 还 可 在 类 级 别 设置 默认 属性 , 以 供 所 有 的 Hystrix 命令 加 以 使 用 。 
Netflix Hystrix 所 供 Y (a)DefaultProperties Eff, XE- Tl 2S2 BERE. JF RI ELS 
Wes mE. UlgroupKey. threadPoolKey. commandProperties. threadPoolProperties. 
ignoreExceptions 和 raiseHystrixExceptions. 
默认 状态 下 ， 所 指定 的 属性 将 用 于 注解 类 《采用 @DefaultProperties 加 以 注解 ) 中 的 
每 条 命令 ， 除 非 某 条 命令 通过 对 应 的 @HystrixCommand 参数 显 式 地 指定 这 些 属性 。 考 查 
下 列 代码 : 
aDefaultProperties(groupKey = "DefaultGroupKey") 
class AccountService [( 
GHystrixCommand // hystrix command group key is 'DefaultGroupKey' 


public Object commandInheritsDefaultProperties() { 


return null; 


a TUN 


} 


精通 Spring Boot 2.0 


aHystrixCommand(groupKey = "SpecificGroupKey") // command overrides 


default group key 
public Object commandOverridesGroupKey() 1{ 


return null; 


j 
j 


Fifi zu H Hystrix Metrics Stream. 


10.7 Hystrix Metrics Stream 


HAR, nJ spring-bootstarter-actuator 上 深 加 依 顿 天 系 ， 进 而 局 用 Hystrix Metrics 
Stream。 通 过 将 巾 ystrix.stream HFE Hima, Hystrix 将 会 公开 数据 流 ， 如 下 所 示 : 


<dependency> 


«groupId»org.springframework.boot«/groupId» 


XartifactId»spring-boot-starter-actuator«/artifactId» 


</dependency> 


此 外 ， 还 可 回应 用 程序 属性 文件 Capplication.propeties) FII FIMEN A: 


management. 
management. 
management. 
management. 
management. 


management. 


endpoint.health.enabled-true 
endpoints.jmx.exposure.include-* 
endpoints.web.exposure.include-* 
endpoints.web.base-path-/actuator 
endpoints.web.cors.allowed-origins-true 


endpoint.health.show-details-always 


如 果 打 算 在 Spring Boot 2.0 中 公开 Hystrix Metrics Stream， 则 需要 使 用 到 上 述 配置 。 

FAEN v asp UJI/hystrix.stream 9m zi. Hm £A Hystrix Metrics Stream。 相 应 地 ， 
http://localhost:6161/actuator/hystrix.stream 表示 为 Hystrix 生成 的 一 个 连续 流 。 该 数据 流通 
过 Hystrix 生成 ， 并 监视 系统 的 健康 状态 以 及 全 部 服务 调用 。 图 10.6 显示 了 对 应 的 输出 


在 图 10.6 F, JSON 数据 用 于 显示 服务 的 健康 监测 结果 ， 以 及 服务 调用 的 监视 数据 
流 。 考 虑 到 相对 复杂 的 JSON 格式 , 因而 该 监视 过 程 较为 困难 。 对 此 , Hystrix 针对 Hystrix 
Metrics Stream 提供 了 一 个 Hystrix Dashboard， 并 可 通过 十 分 简单 的 方式 在 GUI 格式 中 显 
示 相 同 的 数据 。 下 面 将 讨论 Hystrix Dashboard. 
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29 1682252056161 CC 192.1682252086161/2c X Y Sas 


z- x (D 182.168.225,208:6161 /actuator/hystrix. strearn 


ping: 


data: 

i type" :"Hyztrixcommand"," name": "TindByCutomner" ,"group":"AccountseruiceImpl","currentTime":1522888455974, l&sCircultBEreaksrDpen":false,"serrorPercentage" B, errortount":B,"requeztrount":&, 
"rollingCountBadRequests":8 "rali nC ou nL lps aie aao sa," rollingCountEmit":8, "rallingCountExceptionsThrown":0, "rollingCountFailure": n B,"rollingcountFall 
backFailure*: n, "rolHingteunt FallbackMissing":8,"rollingCountFallbackRejection" ;8,"raollingCountFallbeckSuccess" : 0, "rollingCountResponsesFramCache" :8," rollingCountSemaphorc cRejected" e , rol 
lingcountShortCircuited":8, rollingtountsuccess":0, rollingtountThreadPoolRejected": e, "rollingcountTimeout":8, currentConcurrentExecutioncount" :B,"rollingMaxConcurrentExecutioncount :B," 
latencyExecute mean":8,"latencyExecute":["*0":8,"25":0," 50" :0," 75": 8," 08" : 8, "O5" :6, "O0" :0, "90.5": 0, "180" : a," atencyTotal mean" :8," latencyTotal": 

i'a";n,"25":B, "59".90,"75".0, "30" 0, 735";0, "39";0, "32,5" :0, "106" ;0-, "propertyvelue circuitBresekerReguestVolumeThreshold";28,"propertyValue circuitBreakerSleepllindowInlMilliseconds" ;5008, "p 
ropertyvalue circuitBreakerErrarThreshaldPercentage":5e,"propertvvalue circuitBreakerrForceüpen":false,"propertvvalue circuitBreakerrorcerclosed":false,"propertyvalue circuitBreakerEnabled 
"itrue,"propertyValue executionIsolatianStrategy": "THREAD","propertyValue executionIsalationThreadTimeoutInMillizecondzs":1888,"propertyValue executionTimeoutInMilliseconds":1888,"propert 
yValue executionlIsolatianThresdInterruptünTimeaut":true,"propertyValue executionIspletionThreadPFoolKeyOverride":null,"propertyValue executionIsoletionsemsephoreHaxConcurrentRequests";18," 
propertyvalue fallbackIsolationsemaphoreMaxConcurrentRequests":180,"propertyvalue metricsRollingstatisticalwindowInM^I1lllseconds":1e0880,"propertyvalue requestcacheEnabled":true,"propertyWa 
lue requestLogEnabled":true,"reportingHastz":1,"threadPool":"AccountSserviceImpl"| 


data: 

U ERES D"HyztrixThreadPaol","name" rcrum xA EONA S, SATENE De Ic TEE Er CENE PENETCELVCENIRET S B,"currentcompletedTaskCount":B52,"currentCarePool5ize":18,"currentLlargestPool5ize 
"1i18,"currentMaximumPaolSizz":18,' i 10," currentQucucbizc" iB," currentTaskCount" 1:62," rollingCountThreads Executed": 0 B,"rallingMaxActiveThreads" :8, "rollingCountCommandRejection 

s":B,"propertyvalue queueslzeRejectlonThreshald":5,"propertyvalue metricsRollingstatisticalwindowIn"1lliseconds":188e8,"reportingHosts":17 


data: 

i type":"HystrixcCommand"," name" :"TindByCutomer" ,"group" :"Accountserviceimpl","currentTime":1522082466473," lsClrcultBreakerOpen" :false,"errorPercentage":8," "errorCount": 0, "regquestCount": 0, 
"rellingCeuntBadRequeztz":8,"rallingcCounttollapsedRequestz":8,"rollingCountEmit":8,"rallingCauntExceptionzThroun":B8,"rollingCountFailurge":2,"rollingCountFallbackEmit":B,"rollingCountFall 
backFailure":8,"rollingCountFallbackMissing": B, "rollingCountFallbackRejection :0, rollingtountFallbschSuccess":0, rollingCountRespensesFromCache :0, rollingCountzZemapnoreRejectec" :0, "rol 
lingCountshortcirculted":e,"rollingcountsuccess":0,"rollingCountThreadPoolRejected":8,"rollingcountTimeout" i8," currentconcurrentExecutloncount":B,"rollingMaxconcurrentExecutloncount":e," 
latencyExecute mean":8,"latencyExecute":("0^7:8,"25":8,"50":8,"75":8,"00":8,"95" :6, "39" :0, "33.5": 0, "88" : à1, " IatencyTotal mean":8,"latencyTotal": 

['8':8,"25":8,"58" g, "75" 8, "3g" :0, "35" :0, "99" rG, "99,5" r0, "106" :G] , "propertyValue circuitBreakerRequestVolumeThreshold":28,"propertyValue circultBreakerSleepMWindowInMilliseconds" :5888,"p 
ropertyValue circuitBreskert£rrorThreshoaldPercentage":56,"propertyValue circuitBremkerForceOpen": false,"propertyValue circuitBreakerForceClosed": felsce,"propertyValue circuitBreakerEnabled 
"1trus,"propertyValuse executionIsolatianstrategy": "THREAD","propertyWValue executionIszalationThreadTimeaoutlInMillizeconds":1888,"prapertyValue executionTimeoutInHilliseconds":l1888,"propert 
yValue executionIsolatianThreadInterruptOnTimeaut":true,"propertyValue executionIsolationThreadPoolKeyOverride":null,"propertyValue executianIsolationsemaphoreMaxConcurrentRequests" :10,"' 
propertyValue fallbackIsolatiacnsemaphareHaxCaoncurrentReguests" ;18,"propertyValue metricsRolling5tatisticalWindowInMilliseconds";18688,"propertyValue reqguestCacheEnabled":true,"prapertyWa 
lue requestLagEnablsed":true,"repartinpgHazstz":1,"threadPool"-"AcceuntservicsImpl"]| 


图 10.6 


10.8 ”在 项 目 中 实现 Hystrix Dashboard 


Hystrix Dashboard 可 在 仪表 可 上 监视 一 组 数据 指标 , 并 以 一 种 较为 务 单 的 方式 显示 
个 断路 器 的 健康 状态 。 下 和 面 通 过 starter , 基于 org.springframework.cloudand 和 spring- 
cloud-starter-netflixhystrix-dashboard) 在 项 目 中 添加 Hystrix Dashboard, Al P rz: 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
«artifactId»spring-cloud-starter-netflix-hystrix-dashboard«/artifactId» 
</dependency> 


除了 @EnableHystrixDashboard Ż 4h, Mmi] Spring Boot main 类 中 添加 多 个 注解 ， 
如 下 所 示 : 


QSpringBootApplication 
QEnableEurekaClient 
@EnableCircuitBreaker 
@EnableHystrixDashboard 


public class CustomerServiceApplication | 


public static void main(S5tring[|| args) 1 


SpringAppliircation-rüunicustomer5erviceAppliacattron.class, args); 


* 200 * 精通 Spring Boot 2.0 


} 


随后 作为 Spring Boot 应 用 程序 运行 main 2$, 进而 在 当前 项 目 中 运行 Hystrix Dashboard. 
我 们 可 访问 /hystrix Jm si, JPfIoW Hystrix 客户 新 应 用 程序 中 的 单个 实例 /hystrix.stream H 
点 查看 仪表 盘 。 下 面 访 问 http://localhost:6161/hystrix,， 并 在 浏览 器 中 查看 如 图 10.7 所 示 的 
显示 结果 。 
— Hystrix Dashboard 


ES C © G) 192.168.225.208:61 


N% " 


S 
k 
-二 
E 
— 
一 
= 
= 
E sl 
= 
AE 
Y 


2 
力 mn 


Hvstrix Dashboa rd 
http-//hostname:port/turbine/turbine.stream 
Cluster via Turbine (default cluster): http-//turbine-hostname:port turbine stream 
Cluster via Turbine (custom cluster): http-//turbine-hostname:port turbine stream !cluster-[cluster Name] 
Single Hystrix App: http://hvstrix-app:port' hystrix. stream 


Delay: |2000 ims Title: Example Hystrix App 


| Monitor Stream | 
图 10.7 


10.7 显示 了 初始 状态 下 的 可 视 化 仪表 私 。 此 处 回 该 仪表 盘 中 添加 http://localhost: 
6161/actuator/hystrix.stream, 并 单 击 Monitor Stream 按钮 ,进而 获得 Hystrix 组 件 监视 下 的 、 
当前 通路 的 动态 可 视 化 表达 结果 。 在 主页 中 提供 了 流 输 入 信息 后 ， 10.8 显示 了 了 可视化 

Hystrix 利用 /hystrix.stream 冰点 提供 了 与 个 体 实例 相关 的 信息 ， 但 在 分 布 式 系统 中 ， 
有 时 需要 使 用 到 多 个 实例 。 但 是 ， 无 法 利用 Hystrix Dashboard 在 分 布 式 系统 中 获取 与 全 
部 实例 相关 的 协作 视图 。 对 此 ，Spring Cloud Netflix 提供 了 一 个 解决 方案 ， 并 可 整合 与 所 
有 实例 相关 的 全 部 信息 ， 即 Turbine。 下 面 将 对 此 加 以 讨论 。 
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m Hystrk Monitor x Y . 192168225.085161/cu X | VA 
£< A562 F952F192.168.225.208963A616 1962Factuator?62 Fhystrix.stream 
Hystrix Stream: http://192.168.225.208:6161/actuator/hystrix.stream 4 Y HYSTRIX 


Cay" DEFEND YOUR APP 


Circuit Sort: Error then Volume | Alphabetical | Volume | Errcr | Mean | Median | 90| 99 | 93,5 Success | Short-Circuited | | Rejected | Failure | Error Yb 


findByCutomer 
0 | 0 [0.0 9| 
IE 


0 
Host: 0.0/s 
Cluster: O.0/s 
Circuit Closed 
Hosis 1 Both Fims 
Median 31m2 ih Fims 
Mean Jims 995ih Jims 
Thread Pools Sort: Alphabetical | Volume | 
AccountServicelmpl 
Host: O.0/s 
Cluster: 0. 0/s 
0 Max Active 0 
^u l.l i 


10 — Queue Sire 


图 10.8 


109 Turbine PLE & 


Turbine 是 一 个 整合 Hystrix 事件 的 工具 。 假 设 分 布 式 系统 中 涵盖 了 10 多 个 微服 务 ， 
且 每 个 微服 务 均 基于 Hystrix， 因 而 将 难以 监视 全 部 通路 。 针 对 于 此 ，Spring Cloud Netflix 
配置 了 Turbine 方案 ， 进 而 提供 针对 断路 絮 的 整合 结果 。Turbine 系统 将 分 布 式 系统 中 有 所 
有 微服 务 的 /hystrix.stream 整合 至 一 个 合成 的 /turbine.stream, 以 Hystrix Dashboard 供 使 用 。 
当 在 项 目 中 包含 Turbine Hf, PJP] pom.xml 文件 中 添加 下 列 Turbine Maven KRZ: 
<dependency> 
«groupId»org.springframework.cloud«/groupId» 
«artifactId»spring-cloud-starter-netflix-turbine«/artifactId» 
</dependency> 
上 述 代码 针对 Turbine 添加 了 Maven 依赖 关系 。 其 中 ,spring-cloud-starternetflix-turbine 
starter 提供 了 (@EnableTurbine Ef. TIHJVZiXATENE main 应 用 程序 类 将 在 项 目 中 局 用 
Turbine 功能 。 
针对 当前 Turbine 应 用 程序 ， 合 看 下 列 main 应 用 程序 类 : 


package com.dineshonjava.turbine; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.cloud.netflix.eureka.EnableEurekaClient; 


import org.springframework.cloud.netflix.hystrix.dashboard. 


* 202 * 精通 Spring Boot 2.0 


EnableHystrixDashboard; 


import org.springframework.cloud.netflix.turbine.EnableTurbine; 


aSpringBootApplication 
aEnableTurbine 
aEnableEurekaClient 
aEnableHystrixDashboard 


public class TurbineApplication 1 


public static void main(String[] args) 1 


SpringApplication.run(TurbineApplication.class, args); 


} 

main 应 用 程序 类 采用 @EnableTurbine 进行 标注 ， 进 而 在 当前 项 目 中 局 用 Turbine 功 
其 他 注解 则 与 之 前 示例 中 所 用 的 注解 相同 。 

TI Turbine 应 用 程序 ， 考 下 下 列 配置 文件 Capplication.ymD : 


spring: 


中 
CE 
ü 


application: 


name: turbine 


server: 
port- 6202 


eureka: 
client: 
service-url: 
default-zone: $[EUREKA URI:http://localhost:8761/eureka] 
instance: 
prefer-ip-address: true 
turbine: 
aggregator: 
cluster-config: 
一 CUSTOMER- SERVICE 
app-config: CUSTOMER-SERVICE 


ERMA FEA MAEA IRA zim OA Eureka 注册 信息 设置 了 配置 项 ; 同 
WLES T ROREM Turbine 配置 和 appConfig， 这 和 意味 看 ， 我 们 必须 使 用 
(QHystrixcommand 添加 这 些 服 务 。 针 对 Turbine 仪表 盘 ， 此 处 仅 癌 Turbine 聚合 器 中 添 
加 了 一 项 服务 (CUSTOMER-SERVICE . 
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Fi zie Turbine 应 用 程序 ， 图 10.9 显示 了 Eureka Server Dashboard. 


DS Replicas 


Instances currently registered with Eureka 


Application i Availability Zones 
ACCOUNT-SERVICE (1) 
CUSTOMER-SERVICE (1) 


TURBINE (1) 


图 10.9 


在 图 10.9 中 可 以 看 到 ， 当 前 存在 3 个 利用 Eureka 注册 服务 器 注册 的 、 处 于 运行 状态 
下 的 实例 。 

下 面 打 开 Turbin， 并 采用 与 Hystrix Dashboard 相同 的 操作 步骤 ， 但 此 处 通过 Turbine 
近 知 集群 ， 好 http:/localhost:6262/turbine.stream?cluster=CUSTOMER-SERVICE。 对 应 结 
果 如 图 10.10 所 示 。 


HystrirMonitor x Va Hystrir Monitor x * 2 1921682252086 x V 2 1921682252086: x Y (C 19216822520867 x \ py 192168.225208:6; x V o Eureka xh S Dedi 


= x | ®© 192.168.225.208:6262 turbine stream? cluster- CUSTOMER-SERVICE T Ò Œœ Ò e | 


data: 

i rollingcCountFallbacksuccess":8,"rollingcCountFallbackFailure":8,"propertyvalue circuitBreakerRequestvolumeThreshold":z8,"proapertyvalue circuitBreskerForceüpen":false," propertyValue metr 
icsHollingstatisticalWindowInMillisecands":188600,"latencyTotal mean":28,"rollingMaxConcurrentExecutionCount" :1,"type" :"HystrixCommand" ,"rollingCountResponsesFromCache" : 8, "rollingCauntBad 
Requestz";ü,"rollingCountTimeout";B,"propertyValue EexecutionIsolationStrategy" ; "THREAD" ,"rgllingCountFailure";8,"rollingCountExceptionsThrown" ;:6,"rollingzCoeuntrallbackMissing";:6,"threadPa 
ol":"AccountServiceImpl","latencyExecute mnean":20,"isCircuitBreakerÜOpen":false,"errorCount":G,"rollingCount&5emaphoreRejerted":G,"group":"AccountServiceImpl","latencyTotal": 
1'8":20,"35":20,"188":20,"25":28, "38" :20, "50" 120, "D5" 120, "29,5" :20, "75" : 289}, "requestCaunt":7," rollingCounttollapsedRequests":8,"rollingCountshorttircuited" :8,"propertyValue circuitBreake 
rslespWindowuInMillizecondz":5888,"latencyExecute": 

["0":20,"99":20,"1883":28,"25":20, "09" :20, "50" :20, "05" :20, "99.5" :28, "75" :28] , "rollingCauntEmit" :0, " currentConcurrentExecutionCount" :8,"propertyValue executionIsolationtemaphoreMaxCancurre 
ntRequests";la,"errorPercentage";e,"rollingcountThreadPoolRe]ected";a,"propertyValue circultBreakerEnabled":true,"propertyValue executionIsolationThreadInterruptonTimeout" :true,"property 
Value requezttacheEnabled":true,"rollingCountFallbackRejection":G,"propertyValue requestLogEnabled":true,"rollingCountFallbackEmit":G,"rollingtounttuccezz":7,"propertyValue fallbackIsola 


tionSemaphareMaxCancurrentRequests";18,"propertyYalue circuitBreakerErrarThresholdPercentagz";5e6,"propertyVelue circuitBreakerForceClosed" :false "neme": "findByCutomer" ,"reportingHasts";1 
, proapertyvalue executionIzolationThreadPonlKeyüverride":"null","prapertyValue executianIzplatiaonThreadTimeoutiInMillisecondzg":1888,"propertyWalue executionTimeoutlInMilllizecandsz":188g8. 


data: 

i rollingCountFallback&uccezz":8,"rollingCountFallbackFailure":8,"propertyValue circuitBreakerRequeztVolumeThrezshold":28,"propertyValue circuitBreskerForceOpen":falze,"propertyValue metr 
icsRollingStastistiralWindowInMillisercands":18886,"latencyTotel mean":21,"rollingMaxConcurrentExecutionCount" ;l,"type" :"HystrixCommand" ,"rpllingtountResponsesFromCache" :8,"rallingCauntBsd 
Requests":8,"rollingcCountTimsaut":8,"propertyvalue ewecutibnIsolatianstrategy" "THREAD" ,"rpllingcpuntrailure":8a,"rallingcountExceptiansThrown" :8," rbollingcountrallbackMizzing":8,"threadPao 
ol":"AccountServiceImpl","latencyExecute menn":21,"isCircuitBreakerÜpen" : false, "errarCount":8," rollingCountSemaphoreRejected" :8 , "group" : "hccount5erviceImpl","latencyTaotal": 
1'8$":11,"32":57,"188":57,"25":13," 389" :37, "580" 115, "95" 157, 398,5" : 57, "75" : 28], " requestCount":13," rollingcountcCollapsedRequests":a,"rollingCountshortcirculted":e,"propertyValue clrcultBreak 
erSleepWindowInMillizecondz":58880,"latencyExecute": 

i"0";11,"332";56,"180":56,"25":13,"30";37," 58" ;16, "35" 156, "39,5" 56," 75" : 20], rollingCountEmit" :6,"currentConcurrentExecutionCount" ;G,"propertyValugz executionlIsolationSemaphoreMaxConcurre 
ntRequestz":l8,"errarPercentage":8,"rallingcountThreasdPoolRejected" :B,"propertyValue circuitBreakerEnabled":true,"propertyValue executionIzsolationThreadInterruptÜünTimeaut":true,"praperty 
Value requesttacheEnabled":true,"rollingCountFallbackRejection":8," propertyvValue requestlogEnabled":true,"rollingCountFallbackEmit":8,"rollingtountSuccess" :lil,"propertyValue fallbackIsol 
ationsemaphoreMaxConcurrentRequests":18,"propertyValue clrcultBreakerErrorThresholdPercentage":580," propertyvalue circuitBreakerrForceclosed":Talse,"name":"fTindByCutomer","reportingHosts": 
l,"propertyValue executionIsclationThreadPpolkevOverride":"null","propertyValue executionIscolationThreadTimeoutiInMilliseronds":1882,"propertyValue executionTimeoutlnMilliseconds":1899. 


图 10.10 


利用 http://localhost:6262/hystrix 打开 之 前 Hystrix 操作 的 同一 屏幕 ， 并 使 用 /turbine. 
stream "iij ^4 Chttp://localhost:6262/turbine.stream?cluster- CUSTOMER-SERVICE) ) 而 非 不 是 
/hystrix.stream 来 访问 Turbine 仪表 盘 。 这 将 打开 与 Hystrix 相同 的 屏幕 。 但 是 ， 如 果 包 合 
了 多 项 服务 ， 则 会 以 汇总 方式 加 以 显示 ， 如 图 10.11 所 示 。 

不 难 友 现 ,， 这 与 Hystrix Dashboard 十 分 类 似 , 但 Turbine 仪表 税 将 全 部 /hystrix.stream 
端 点 整合 至 单一 的 /turbine.stream 端点 中 。 

接 下 来 讨论 Turbine stream 及 其 应 用 。 
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CHEN 


F ad Hystrix Monitor x V L2 Hystrix Monitor (^ 1921682252086161/, x V 2 1921682252086161/c. x V 


< C | © 192.168.225.208:6262/hystrix/monitor?stream - http963A962F962F192.168.225.208963A6262962Fturbine.stream?63Fcluster963 


Hystrix Stream: http://192.168.225.208:6262/turbine.stream?clusterz CUS TOMER-SERVICE 
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对 于 PaaS 这 一 类 环境 , 经 典 的 Turbine 可 以 从 所 有 的 分 布 式 Hystrix 命令 中 提取 度量 
指标 。 其 间 ,通过 Spring Cloud 消息 传输 机 制 , 可 以 将 Hystrix 命令 推送 指标 推送 全 Turbine 
中 。 对 此 ， 客 户 痪 应 用 程序 所 需 的 依赖 关系 如 下 所 未 : 

«dependency» 

«grouplId»org.springframework.cloud«/groupId» 
«artifactlId»spring-cloud-starter-netflix-turbine-stream«/artifactId» 
</dependency> 


<dependency> 
«groupId»org.springframework.cloud«/groupId» 
*arbitactld»spring-cloud-sLarter-sbream-rabbsts/art:fackrd-» 
</dependency> 
HEPI S spring-cloud-starter-netflix-turbine-stream 和 springcloud-starter-stream-rabbit 
Starters; 但 也 可 利用 spring-cloud-starter-stream-*743J]] Spring Cloud 的 任意 消息 传输 代理 
Starter. 5j/h, em mEnableTurbineStream 对 Spring Boot 应 用 程序 类 进行 注解 。 


10.10 基于 Hystrix 和 Feign 的 REST 使 用 者 


之 前 曾 通 过 Spring Framework 的 RestTemplate 使 用 微服 务 。 下 面 将 把 Spring Netflix 
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Feign 用 作 声 明 式 REST 27" im, MIJE Spring RestTemplate， 进 而 使 用 微服 务 。 关 于 利用 
Spring Netflix Feign 访问 REST API, B 8 章 兽 对 此 有 所 讨论 。 本 而 将 使 用 基于 断路 礁 模 
式 的 Feign 2 P? "rij o 
如 果 Hystrix 位 于 类 路 径 上 ， 且 有 feign.hystrix.enabled = true, HWA, Feign 4A Wr 
路 器 封装 所 有 方法 。 
在 Spring Cloud Dalston 版 本 之 前 ， 如 果 Hystrix 位 于 关 路 径 上 ， 默 认 状态 下 ，Feign 
将 把 所 有 方法 封装 至 断路 器 中 。 这 一 默认 行为 在 Spring Cloud Dalston 中 发 生 了 变化 且 作 
为 可 选项 加 以 设置 。 
当 疝 项 目 中 添加 Feign 客户 端 时 ， 需 要 添加 下 列 Maven 依赖 关系 : 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-openfeign</artifactId> 
</dependency> 
下 面 针 对 给 定 的 @FeignClient 启用 回 退 ， 也 就 是 说 ， 将 类 名 设置 为 (实现 了 回 退 的 》 
该 注解 的 回 退 属性 。 除 此 之 外 ， 还 需要 将 对 应 实现 声明 为 Spring Bean。 作 为 Feign 客户 
端 接口 ， 考 得 下 列 AccountService: 


aFeignClient (name-"account-service", fallback-AccountServiceFallback.class) 
public interface AccountService 1 
QGetMapping (value = "/account/customer/ícustomer]") 


List«Account» findByCutomer (8PathVariable ("customer") Integer customer); 


class AccountServiceFallback implements AccountService { 
aOverride 
private List«Account» findByCutomer (Integer customer) { 
List<Account> defaultList = new Arrayblistc-(); 
defaultList.add(new Account (0000, 1.000, 0000, "UNKNOWN 
ACCOUNT TYPE”; "UNK", “FALLBACK BANEK'")); 


return deraultbLhist: 


} 


@FeignClient 的 名 称 属性 不 可 或 缺 ,。 如 果 给 定 该 属性 , 它 将 通过 服务 发 现 (基于 Eureka 
Client) 或 URL ÆR HESY o 
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10.11 A x ^ %4 


本 章 介 绍 了 Spring Cloud Hystrix 断路 器 ， 以 及 分 布 式 应 用 程序 中 针对 容错 机 制 的 断 
路 器 模式 。 其 中 ， 我 们 利用 Spring Netflix Hystrix 创建 了 一 个 应 用 程序 ， 并 对 通路 的 开放 
路 径 和 闭合 路 径 进行 测试 。 另 外 ， 本 章 还 实现 了 客户 奖 应 用 程序 ， 并 利用 Spring 的 
RestTemplate 使 用 REST 微服 务 ; 此 外 ， 还 使 用 到 了 Spring Cloud 的 Netflix Feign。 

同时 ， 本 章 还 讨论 了 如 何 目 定义 Hystrix 命令 和 回 退 的 默认 配置 。 另 外 ， 我 们 还 探讨 
了 Hystrix 命令 中 的 错误 传递 机 制 。 

接 下 来 ， 本 章 分 别 使 用 RestTempate 和 Feign 客户 端 创建 了 两 个 使 用 者 应 用 程序 。 最 
终 ， 我 们 还 构建 了 Hystrix Dashboard， 进 而 监视 项 目的 度量 指标 。 相 应 地 ，Turbine 仪表 
本 可 将 分 布 式 系统 中 全 部 微服 务 的 所 有 /hystrix.stream 冰点 整合 全 一 个 合成 的 /turbine. 
stream "jj A FH o 

对 于 构建 分 布 式 系统 , 本 章 还 曾 述 了 断路 器 实现 的 必要 性 , 以 及 如 何 使 用 Hystrix 库 ， 
并 针对 具体 业务 需求 对 其 进行 目 定 义 。 男 外 ， 我 们 还 学 习 了 利用 个 体 服 务 中 的 数据 流 配 
置 Hystrix Dashboard， 以 及 配置 Turbine 仪表 可， 进而 整合 来 自 多 项 服务 的 数据 流 。 

第 11 章 将 讨论 Spring Boot 针对 测试 机 制 的 支持 。 
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训 试 用 例 对 于 应 用 程序 来 说 十 分 重要 ， 它 们 不 仅 可 以 验证 代码 ， 还 可 确 傈 一 切 顺 利 
进行 。 本 章 将 讨论 如 何 编写 测试 程序 ， 以 使 应 用 程序 在 执行 过 程 中 不 会 因 中 上 断 而 产生 问 
题 。 读者 可 在 代码 编写 之 前 或 之 后 编写 测试 程序 o 

Spring 并 未 针对 应 用 程序 提供 相应 的 API USMARC. Spring HAHAE GU 
接口 驱动 等 特征 ， 因 此 对 于 Spring 应 用 程序 来 说 可 较为 方便 地 编写 测试 单元 。 另 外 一 方 
面 ， 集 成 测试 需要 借助 于 Spring Framework， 其 原因 在 于 ，Spring 在 产品 应 用 程序 的 应 用 
程序 组 件 之 间 采 用 了 Bean 连接 ， 因 此 ，Spring 负责 配置 、 创 建 产 品 应 用 程序 中 的 应 用 程 

序 组 件 。 

Spring 针对 BiU s 了 一 个 独立 的 组 件 ， 即 Spring test. Spring test 模块 提供 了 
SpringJUnitAClassRunner 类 ， 从 而 可 帮助 加 载 基于 JUnit 应 用 程序 测试 中 的 Spring 应 用 程 
序 上 和 下文。 但 在 默认 状态 下 , Spring Boot 会 启用 目 动 配置 , 并 提供 了 一 个 类 SpringRunner. 
此 外 ，Spring Boot 还 包含 了 一 些 十 分 有 用 的 测试 工具 。 

本 章 首 先 查 看 如 何 测试 Spring Boot 应 用 程序 上 下 文 ， 其 中 涉及 单元 测试 Spring Boot 
服务 ， 以 及 模拟 Spring Boot 服务 。 除 此 之 外 ， 我 们 还 将 了 解 不 同 的 工具 ， 以 对 包含 基本 
用 途 的 服务 自 约 进行 测试 。 本 章 将 巡 过 公开 条 些 REST URI 进而 创建 一 个 REST 应 用 程 
序 ， 并 于 随后 利用 Postman 和 SoapUI 工具 进行 测试 。 在 阅读 完 本 章 后 ， 读 者 将 能 够 更 好 
地 理解 Spring Boot 对 测试 机 制 的 支持 方式 。 

本 章 主 要 涉及 以 下 内 容 : 
测试 驱动 开 友 。 

Spring Boot 的 JUnit Jl iX. 

在 模拟 服务 时 使 用 Mockito. 

使 用 Postman Mi RESTA 服务 契约 。 
使 用 SoapUI 测 斌 RESTful 服务 契约 。 
下 面 将 对 此 进行 逐一 讨论 。 


LLLLL 


11.1. 测试 驱动 开发 


测试 驱动 开发 (TDD) 与 编写 目 动 化 测试 相关 ， 进 而 验证 代码 最 终 是 否 可 正 第 工作 。 
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TDD 主要 关注 包 合 测试 形式 且 定 义 民 好 的 需求 条 件 的 开发 。 每 个 开发 过 程 都 包含 以 目 动 
化 或 手动 方式 进行 的 测试 。 目 动 化 测试 会 寻 臻 忌 体 上 更 快 的 开发 周期 。 同 时 ， 有 效 的 TDD 
其 速度 远 优 于 没有 测试 的 开发 过 程 。 此 外 ， 全 面 的 测试 履 盖 为 应 用 程序 开发 提供 了 信 
心 ， 并 可 有 效 地 文 持 应 用 程序 的 重 构 。 重 构 对 于 应 用 程序 的 敏捷 开 肥 是 必 不 可 少 的 。 考 
fr Kd 11.1. 


Pass 


Fail, fix LL, P, 


M» Refactor 


图 11.1 
重 构 对 敏捷 开发 提供 了 正面 支持 ， 进 而 可 方便 地 发 现 故 障 并 对 其 进行 修复 。 
另外 ， 测 斌 机制 也 会 使 我 们 重新 思考 设计 方案 。 如 果 代 人 码 难 以 测试 ， 则 需要 重新 审 
视 之 前 的 设计 方案 ， 而 测试 用 例 则 可 使 我 们 专注 于 某 些 重要 的 事情 ， 同 时 还 可 帮助 我 们 


避免 编写 不 必要 的 代码 ， 并 在 开发 过 程 的 早期 发 现 问 题 。 接 下 来 考 合 软件 中 不 同 的 测试 


11.2 单元 测试 机 制 


单元 测试 将 测试 一 个 功能 单元 ， 它 使 依赖 关系 最 小 化 并 与 环境 隅 离 ， 包 括 Spring. 
对 于 依赖 项 ， 我 们 可 以 使 用 人 徐 化 的 蔡 代 方案 ， 如 Stub 和 /或 Mock. 

在 单元 测试 机 制 中 ， 无 须 设置 任何 外 部 依赖 关系 一 一 针对 某 个 单元 进行 测试 不 存在 
有 效 的 外 部 依赖 关系。 因此 ， 可 移 除 包含 依赖 关系 的 链接 。 相 应 地 ， 测 试 过 程 不 会 因 依 
赖 项 而 出 现 故障 。 除 此 之 外 ， 针 对 测试 目的 ， 还 可 移 除 对 应 实现 的 外 部 依赖 关系 ， 即 使 
用 Stub GR) 或 Mock RHAL) 。 这 里 ，Stub 将 使 用 一 个 模拟 框架 创建 一 个 简单 的 测试 实 
现 ， 以 及 一 个 在 局 动 时 生成 的 Mock 依赖 关系 类 。 

图 11.2 显示 本 与 单元 测试 相关 的 示 总 图 。 

其 中 可 以 看 到 两 种 应 用 程序 模式 ， 即 生产 模式 和 单元 测试 模式 。 在 生产 模式 中 ， 
Spring Framework 通过 Spring 配置 注入 依赖 关系 ; 但 在 单元 测试 模式 中 ，Spring 则 未 起 
到 任何 作用 ， 依 赖 关 系 通 过 创建 Stub 实现 加 以 解决 。 
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基于 Stub 的 单元 测试 


AccountServiceImpl AccountServiceImplTest 


AccountRepository AccountServiceImpl 


AccountRepositoryStub 


Stub 实现 或 
AccountRepository 


不 需要 DB 


图 11.2 


在 当前 示例 中 ， 需 要 针对 AccountServiceImpl 类 生成 一 个 单元 测试 ， 并 对 两 个 方法 进 
fr 测试 ， 即 findAccountByAccountId() 和 findAllByCustomerld()) 方法。 其中， 
findAccountByAccountId0 方 法 将 返回 与 账户 ID 关联 的 账户 对 象 ; findAllByCustomerIdO 
方法 则 返回 某 位 客户 的 账户 列表 。 

下 面 定 义 AccountServiceImpl 类 ， 并 通过 单元 测试 对 该 类 进行 测试 ， 如 下 所 示 : 

public class AccountServicelmpl implements AccountService | 


aAutowired 


AccountRepository accountRepository; 


public AccountServicelImpl(AccountRepository accountRepository) { 
this.accountRepository = accountRepository; 

} 

QOverride 

public Account findAccountByAccountId(Integer accountId) { 


return accountRepository.findAccountByAccountId (accountId); 


} 


aOverride 


public List«Account» findAllByCustomerId(Integer customerId) { 


return accountRepository.findAllByCustomerId (customerId); 
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上 述 服 务 类 利用 AccountRepoistory 实现 包含 了 一 个 依赖 关 系 。 下 面 针 对 
AccountServiceImpl 类 的 单元 测试 完成 AccountRepository 的 Stub 实现 ， 如 下 所 示 : 


public class StubAccountRepository implements AccountRepository í( 


QOverride 
public Account findAccountByAccountId(Integer accountId) { 
return new Accounttrü0. 171.31, IDDOU., SAVING", 'HDECIZI", HDEC") ; 


} 
QGOverride 
public List«Account» findAllByCustomerId(Integer customerId) { 


List«Account» accounts = new ArrayListc^»(); 
accounts .add (new Account (100, 121.31, 1000, "SAVING", -HDECTZT"U. 


"HDPBU" $11; 
accounts .add {new Account (200, 221.31, 10080, "CUBBENT", "ICICIZI", 


EDU TTA 
return accounts; 


} 

StubAccountRepository 表示 为 AccountRepository 的 Stub 实现 ， 也 就 是 说 ， 在 未 调用 
实际 数据 库 的 情况 下 ， 利 用 虚拟 数据 实现 了 当前 方法 。 图 11.3 解释 了 AccountRepository 
的 两 种 实现 方式 。 


AccountRepository 


图 11.3 
根据 图 11.3， 应 用 程序 中 包含 了 AccountRepository 的 两 种 实现 。 其 中 ， 
JPAAccountRepository 用 于 生产 模式 ， 同 时 使 用 了 数据 库 集成 ; 而 男 一 个 类 
StubAccountRepository 则 用 于 单元 测试 ， 且 未 集成 数据 库 依赖 关系。 下 列 类 通过 该 Stub 
存储 库 创建 了 一 个 单元 测试 ， 其 中 ，AccountServiceImplTest 表示 为 一 个 采用 Stub 存储 库 
的 时 元 测试 。 


package com.dineshonjava.accountservice; 
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import sLaskrc otrg.jüunrt.Asserb.asserbtbalse: 


import static org.junit.Assert.assertTrue; 


import org.junit.Before; 


import org.junit.Test; 


import com.dineshonjava.accountservice.repository.StubAccountRepository; 


import com.dineshonjava.accountservice.service.AccountService; 


import com.dineshonjava.accountservice.service.AccountServiceImpl; 


public class AccountServiceImplTest { 


AccountService accountService; 

QBefore 

public void setUp() 1 
accountService = new AccountServiceImpl( new 
StubAccountRepository() ); 

} 

aTest 

public void findAccountByAccountId() 1 


assertTrue(accountService.findAccountByAccountId(100).getBalance(). 
ThbValucst) == 121}; 


} 


} 

aTest 

public void findAllByCustomerId() { 
assertFalse(accountService.findAllByCustomerId(1000).size() —-3); 


上 述 代 码 定 义 了 3 个 方法 ， 其 中 ，setup0 方 法 初始 化 AccountRepository， 并 采用 
(QBefore 进行 标注 。 这 和 意味 看 ，setup0 方 法 将 在 测试 方法 执行 之 前 航 调 用 。 训 斌 关中 的 其 
他 两 个 方法 fmndAccountByAccountId0 和 findAllIByCustomerIdO0 则 定义 为 测试 方法 ， 并 通 
过 @Test 加 以 注解 。 这 表明 ， 此 类 方法 定义 为 测试 方法 。 这 些 测试 方法 中 包含 了 相应 的 
训 弃 逻辑 ， 我 们 将 采用 断言 编号 测试 馆 辑 。 


11.2.1 


A 7L TB TC Ea 


在 单元 测试 中 使 用 Stub 实现 具有 以 下 优点 : 


图 
图 


易于 实现 和 理解 。 
具有 可 复 用 性 。 
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11.2.2 ”单元 测试 的 缺点 


在 单元 测试 中 使 用 Stub 实现 具有 以 下 缺点 : 

口 “ 调 整 接口 时 也 需要 修改 Stub. 

O Stbu 需要 实现 全 部 方法 ， 即 使 是 那些 未 被 特定 场合 使 用 的 方法 。 
D 复 用 Stub 时 ， 重 构 将 会 破坏 其 他 测试 。 


11.2.3 其 他 模拟 库 


除了 Stub 实现 之 外 ， 还 存在 其 他 一 些 模拟 框架 ， 并 可 以 此 创建 单元 测试 。 一 些 模拟 
库 包 括 Mockito、jMock 和 EasyMock。 例 如 ， 当 采用 Mock 库 执 行 测试 时 ， 需 要 完成 以 
下 操作 步骤 : 

(1) 使 用 模拟 库 生 成 一 个 模拟 对 象 ， 并 动态 实现 依赖 接口 。 

(2) 记录 模拟 ， 并 预测 它 将 如 何 应 用 于 茶 个 场景 中 。 

(3) 使 用 场景 。 

(4) 验证 模拟 的 期 望 结果 是 否 满足 要 求 。 

上 述 各 步 又 包含 以 下 优 操 : 

D 无 须 维护 额外 的 类 。 

Q ” 仪 需 针对 测试 创建 设置 相关 内 容 。 

唯一 的 缺点 是 ， 这 些 库 初 看 之 下 难于 理解 。 


113 集成 测试 


集成 测试 也 称 作 系统 测试 ， 进 而 测试 多 个 协同 工作 的 单元 交互 行为 。 所 有 的 单元 都 
应 该 单独 工作 得 很 好 ， 因 为 我 们 已 经 执行 了 单元 测试 来 确认 这 一 点 ; —— 
在 不 运行 整个 项 目的 情况 下 在 其 周围 基础 及 施 的 上 下 文中 测试 应 用 程 | Sy 335b, 
使 用 Apache DBCP 连接 池 ( 而 非 通过 JNDI 获得 的 容器 提供 者 连接 池 )， 并 采用 et 
KAE 9 Ep vx JR] NV. JMS 许可 证 。 

图 11.4 显示 了 集成 测试 的 示 章 

在 图 11.4 中 可 以 看 到 ， a- 使 用 了 实际 的 AccountRepository 实现 ， 
而 不 是 单元 测试 中 所 用 的 Stub 实现 。 但 是 ，JpaAccountRepository 将 从 测试 DB 中 获取 数 
据 ， 而 非 产 品 DB. Spring 通过 Spring-test.jar 库 支 持 集 成 测试 ， 对 于 测试 环境 ，Spring 可 
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EHIE MHEMA. HAEA MHIE H EAKR A o 


集成 测试 


Spring 注入 


AccountServiceImpl AccountServiceI mpl 


Spring 注入 [ Spring 注入 


JpaAccountRepository JpaAccountRepository 


产品 AccountDB 测试 AccountDB 


图 114 


Spring 提供 了 一 个 独立 的 模型 〈spring-test.jar) 用 于 集成 测试 ， 并 由 多 个 JUnit 测试 
关 构 成 。 其 中 ，Spring ES | —^ p p 5x 42S, B] SpringJUnit4ClassRunner, iZ2$ T4 t di 
试 方法 间 绥 存 一 个 共享 的 ApplicationContext。 

A ASA: 


aRunWith(SpringJUnit4ClassRunner.class) 


aContextConfiguration(classes-SystemTestConfig.class) 
public final class AccountServicelImplTest [1 
QAutowired 


AccountService accountService;j 


aTest 

public void findAccountByAccountId() | 
assertTrue(accountService.findAccountByAccountId(100).getBalance(). 
»ntvaluet) — 121}; 

} 

aTest 

public void findAllByCustomerId() { 
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assertFalse(accountService.findAllByCustomerId(1000).size() -—-3); 


ESME AccountServiceImplTest M41 SpringJUnitdClassRunner 关 并 采用 
@RunWith EFH, Ze8jizJW iE Spring 的 基础 上 运行 。 态 外 ， 人 ep 
注解 用 于 包含 测试 配置 ，SystemTestConfig 类 则 指 问 系统 测试 配置 文件 。 恋 痢 可 能 已 经 注 
意 到 ， 此 处 并 未 采用 @Before 注解 ， 其 原因 在 于 ，AccountService 依赖 关系 通过 Spring 注 
入 ， 因 而 无 须 使 用 @Before 注解 。 

除了 加 载 应 用 程序 上 下 文 之 外 , SpringJUnit4ClassRunner 还 可 将 应 用 程序 上 下 文中 的 
Bean 通过 上 自动 连接 注入 测试 上 自身 中 。 由 于 当前 测试 的 目标 是 AccountService Bean, 因而 
可 目 动 连接 至 测试 中 。 最 后 ，findAccountByAccountId0 调 用 地 址 服务 并 对 结果 进行 验证 


11.3.1 Spring 测试 的 优点 


Spring 集成 测试 包含 了 以 下 优点 : 

D 无须 部 蜀 外 部 容器 进而 测试 应 用 程序 功能 ， 可 在 IDE 中 快速 地 运行 一 切 事物 。 

QU ” 文 持 持续 集成 测试 ， 并 可 复 用 测试 和 生产 环境 则 的 配置 一般 情 况 下 ， 应 用 程 
HF Bo E32 ROI 555 n] I3 LH] o 


11.3.2 激活 测试 类 的 配置 


Spring 测试 模块 在 test 类 中 提供 了 @ActiveProfiles 注解 , 该 注解 可 激活 测试 环境 中 的 
配置 内 容 。 通 过 该 配置 所 激活 的 Bean 将 执行 实例 化 操作 ;而 那些 未 与 任何 配置 天 联 的 
Bean 也 将 被 实例 化 。 例 如 ， 在 下 列 代 码 中 ，prod 和 dev 两 项 配置 将 被 激活 。 


aRunWith(SpringJUnit4ClassRunner.class) 
aContextConfiguration(classes-TestConfig.class) 
HACLIveProfiles( { "prod", "dev" } ) 


public class AccountServicelmplTest | 


} 


11.4 Spring Boot 应 用 程序 的 JUnit 测试 


Spring Boot 针对 测试 提供 了 两 个 模块 ， 即 sprint-boot-test 和 springboot-test-autoconfigure. 


其 中 ，spring-boot-test FES f Z4 VJ €. springboot-test-autoconfigure 则 支持 测试 的 自动 
配置 。 这 一 类 模块 涵 产 了 多 个 工具 和 注解 , 这 在 测试 应 用 程序 时 十 分 有 用 。 另 外 , I8] Spring 
Boot 应 用 程序 中 添加 此 类 模块 也 较为 简单 H] Maven 文件 中 加 入 spring-bootstarter-test 


starter 依赖 关系 即 可 。 访 starter 将 导入 Spring Boot 模块 、AssertJ、Hamecrest 以 及 其 他 库 。 
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下 列 Maven 依赖 关系 将 在 Spring Boot 应 用 程序 中 纳入 对 测试 的 支持 。 


<dependency> 


«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-test«/artifactlId» 
«scope»testc«/scope» 


</dependency> 


上 述 Maven 依赖 关系 将 问 Spring Boot 应 用 程序 中 加 入 下 列 库 。 
Q JUnit: 这 与 Java 应 用 程序 的 单 死 汕 试 相关 。 


口 Spring 测试 和 Spring Boot 测试 : 针对 Spring Boot 应 用 程序 添 加 集成 测试 方面 的 


LFF o 


LDLDLLL 


Assert]: 表示 为 一 个 断言 库 。 
Hamcrest: 该 库 与 约束 和 谓词 相关 。 
Mockito: 表示 为 Java 模拟 框架 。 
JSONassert: 运 库 用 于 JSON 文 持 下 的 断言 。 
JsonPath: 针对 JSON H5 XPath. 

当 编 写 测试 程序 时 ,上 述 库 十 分 有 用 。Spring Boot 提供 了 一 个 注解 @SpringBootTest， 
该 注解 可 用 于 Spring 测试 模块 的 @ContextConfiguration 注解 的 奉 代 方案 ， 并 可 通过 


SpringApplication 在 测试 中 生成 ApplicationContext。 考 但 下 列 类 : 


package com.dineshonjava.accountservice; 


import 


import 


import 
import 
import 
import 


import 


import 


static org.junit.Assert.assertFalse; 


static org. junit.Assert-assertETrue; 


Org 


Org. 
Org. 
org- 


org. 


com. 


-QjunrLt-Test; 


junit.runner.RunWith; 
springframework.beans.factory.annotation.Autowired; 
springframework.boot.test.context.SpringBootTest; 


springframework.test.context.junit4.SpringRunner; 


dineshonjava.accountservice.service.AccountService; 


aRunWith(SpringRunner.class) 


(25 


一 上 
一 
| 


aSpringBootTest 
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public class AccountServiceApplicationTests [ 


aAutowired 


AccountService accountService; 
aTest 
public void findAccountByAccountId() 1 


assertTrue(accountService.findAccountByAccountId(100).getBalance(). 
3902); 


intValue () 


} 


aTest 
public void findAllByCustomerId() { 


} 


assertFalse(accountService.findAllByCustomerId (1000) .size() 


ddr 


该 类 采用 @SpringBootTest 进行 注解 ， 且 无 有 顷 添 加 @ContextConfiguration 注解 。 


11.$ 使 用 Mockito 模拟 服务 


关于 Mockito 岁 扮演 的 角色 ， 查 看 下 列 引 文 : 


“Mockito 是 一 个 模拟 框架 
让 用 户 感 到 任何 不 适 


Apa TA AES, 


—— 的 远程 服务 的 facade。 除 此 之 外 ， 


出 现 的 故障 时 ， 


import 
import 
import 
import 
import 


import 


import 


static 
static 
static 
static 
static 


static 


， 可 使 用 简单 的 API 编写 漂亮 的 测试 程序 。Mockito 不 会 
测试 具 有 较 好 的 5 可 读 性 ， 并 会 产生 清晰 的 验证 错误 ”。 
— —Mockito 


东 些 时 候 需 要 在 应 用 程序 上 下 文中 模拟 特定 的 组 件 。 例 如 ， 可 能 存 


当 试 图 模拟 真实 环境 中 难以 


一 模拟 机 制 同 样 有 效 。 对 此 ， 考 查 下 列 测试 类 : 


package com.dineshonjava.accountservice; 


org- 
Org. 
Org. 
org. 
org. 


org 


hamcrest.CoreMatchers.1is; 
hamcrest.CoreMatchers.notNullValue; 
Junit.Assert .assertFalse; 
jüntt.Assert.assert That; 


junit.Assert.assertTrue; 


-mockrito.Mockito.*- 


org.junit.Test; 
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import org.junit.runner.RunWith; 
import org.springtramework.boot.test.context.S5pringBootETest; 
import org.springframework.boot.test.mock.mockito.MockBean; 


import org.springframework.test.context.junit4.SpringRunner; 


import com.dineshonjava.accountservice.domain.Account; 


import com.dineshonjava.accountservice.service.AccountService; 


aRunWith(SpringRunner.class) 
aSpringBootTest 
public class AccountControllerTest 1| 
aMockBean 
AccountService accountService; 
aTest 
public void findAllByCustomerId() I 
assertFalse(accountService.findAllByCustomerId(1000).size() ==3); 
} 
aTest 
public void testAddAccount returnsNewAccount () { 
when (accountService.save(any(Account.class))).thenReturn (new 
Account (200, 200.20, 1000, "SAVING", "SBIWOPITV. "SBIW"Ij; 
assertThat(accountService.save(new Account (200, 200.20, 1000, 
"SAVING", "SBIWO111", "SBIW")), is(notNullValue())); 
} 
aTest 
public void findAccountByAccountId() 1 
assertTrue(accountService.findAccountByAccountId(200).getBalance(). 
zniwvutueotp-—--2B9034- 
} 


Spring Boot 包含 了 一 个 @MockBean 注解 , 并 可 在 ApplicationContext 中 针对 Bean 定 
义 一 个 Mockito。 另外 , 可 采用 该 注解 添加 一 个 新 的 Bean, 或 者 蔡 换 一 个 现 有 的 Bean 定义 。 
该 注解 可 以 直接 用 于 test 类 、 测 试 中 的 字段 或 @Configuration 类 和 字段 上 。 当 用 于 字段 上 
时 ， 所 创建 的 Mock 实例 也 将 被 注入 。 在 每 个 测试 方法 之 后 ，Mock Bean 将 目 动 被 重 置 。 


11.6 测试 RESTful 服务 契约 的 Postman 


Postman 是 一 个 REST 客户 端 ， 最 初 是 一 个 Chrome 浏览 器 插件 ， 但 最 近 推 出 了 


* 218* 精通 Spring Boot 2.0 


Mac 和 Windows 的 本 地 版 本 。Postman 支持 各 种 HTTP 方法 ， 甚 至 包括 一 些 我 们 不 曾 
了 解 的 方法 。 下 面 首先 在 机 器 上 安装 Postman， 并 在 安装 完毕 后 打开 Postman。 其 使 用 
过 程 也 较为 简单 一 一 打开 Postman 并 利用 谷歌 账户 登录 即 可 。 当 前 ，Postman 可 用 于 测试 
RESI API. 

图 11.5 显示 了 REST API 的 Postman 测试 画面 。 


NEW IN Runner Import B Builder 


F Chrome apps are being deprecated. Download our free native apps for continued support and better 


http://192.168.225.208:6060/account/customer?customer=1000 


ders (2) Body e 


form-data x-www-form-urlencoded — * raw 


4 
ms 


"accountId": 400, 
"balance"; 4502.92, 
"customerId": 1009, 
"accountType"; "SAVING", 
"branchCode": "HDFC8G86", 
"bank": "HDFC" 


| Cm A d € Pi je 


ea 


图 11.5 


图 11.5 显示 了 与 Postman 相关 的 一 些 内 容 ， 此 处 测试 了 一 个 RESTful Web 服务 ， 并 
针对 某 位 客户 利用 客户 ID 1000 创建 了 一 个 账户 ， 如 下 所 示 。 


http://192.168.225.208:6060/account/customer?customer-1000 


其 中 ， 数 据 头 中 包含 了 如 图 11.6 所 示 的 信息 。 

可 以 看 到 ,图 11.6 中 显示 了 与 请 求 和 啊 应 头 相 关 的 信息 ， 在 请 求 头 中 ，Content-Type 
表示 为 applicatiomr/json;， 在 啊 应 头 中 ， 内 容 类 型 同样 选取 为 application/json; 同时 还 显示 
了 日 期 和 API 啊 应 的 编码 信息 。 

Postman 还 可 针对 某 个 API 编写 测试 用 例 ， 如 图 11.7 所 示 。 
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NEW [|] Runner Import E Builder 


Q Chrome apps are being deprecated. Download our free native apps for continued support and better performance. Learn more 


No Environment 


http://localhost:6060/account Params 


Headers (2 


Value Description 
B Content-Type application/json 


Authorization Basic YWRtaW46c2VjcmVO 


Headers (3) 


content-type 一  application/]Json;charset-UTF-8 
date 一 Sun, 01 Apr 2018 17:58:52 GMT 


transfer-encoding 一 chunked 


图 11.6 


NEW IN Runner Import E Builder 


Mo Environment 


"2 19 


http://localhost:ó060/account Params 


s (2) Pre-request Script Tests © 


responseCode.code === 208; 


tests["Status code is 288"] = 
- postman.getResponseHeader("Content-Type"); 


"egit Test scripts are written in JavaScript, and are 
tests["application/json"] 


run after tha responsa is received. 


Lu m3 deb 


var jsonData = JS0N.parse(responseBody); 
tests["accountId"] = jsonData.value === 400; 


ui da 


Headers (3) Test Results (2/3) 


Status code is 200 


application/json 


图 11.7 


办 
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这 里 通过 Postman 工具 创建 了 一 些 测 试用 例 ; 选择 Test AWF, zer DIL 
SNIPPETS 一 栏 ， 其 中 创建 了 3 个 测试 。 相 应 地 ， 第 一 个 测试 检测 响应 代码 ;第 二 个 测试 
检测 啊 应 的 内 容 类 型 ， 第 三 个 测试 则 检测 返回 的 JSON 数据 值 。 


11.7 AR € LZ 


测试 机 制 是 开发 过 程 中 不 可 或 缺 的 部 分 。 单 元 测试 将 对 一 个 类 进行 隔离 测试 外 部 
依赖 关系 将 处 于 最 小 化 。 针 对 单元 测试 ， 我 们 可 壬 试 创建 Stub 或 Mock， 且 无 须 使 用 到 
Spring。 集 成 测试 则 对 多 个 协同 工作 的 单元 的 交互 行为 进行 测试 。 针对 不 同 的 测试 和 部 蕴 
配置 ，Spring 针对 集成 测试 提供 了 较 好 的 文 持 。 

本 章 中 提 及 了 多 种 工具 可 用 于 测试 服务 ， 如 Postman 和 SoapUI。 其 中 ， 我 们 考查 了 
如 何 采 用 Postman 对 RESTful 服务 进行 测试 。 Postman 对 于 包含 各 种 内 容 类 型 的 HITP 77 
法 均 提 供 了 相应 的 文 持 。 

第 12 章 将 讨论 Docker Ai, HAEE Docker 镜像 。 


第 12 草 微服 务 的 容器 化 


本 章 将 讨论 容器 、 服 务 的 Docker 化 、 编 写 Dockerfile， 以 及 利用 docker-compose 2 
PEET n EN bom TI 

第 11 章 学 习 了 微服 务 的 架构 及 其 优 、 缺 点 。 分 布 式微 服务 应 用 程序 面临 的 主要 挑战 

是 多 台 机 器 (VM) 间 多 项 微服 务 的 部 车 。 那 么 ， 如 何 共享 VM 的 公共 资源 ?在 生产 
s 段 ， 由 多 项 微服 务 构成 的 系统 的 部 署 和 管理 在 操作 层面 上 来 讲 是 十 分 复杂 的 。 

在 微服 务 架 构 中 ， 可 独立 地 创建 和 部 羞 服务， 并 可 在 同一 个 VM ERE Ja BEAON 
服务 进行 测试 。 当 前 微服 务 并 不 会 影响 到 其 他 微服 务 ， 但 由 于 服务 间 彼 此 独立 ， 因 而 无 
法 确保 正确 地 使 用 VM 的 公共 资源 。 

台 微 服务 架构 来 说 ， 容 器 部 署 一 般 位 于 最 顶端 。 微 服务 已 经 通过 其 功能 服务 实现 了 
上 自治， 但 通过 目 包 含 确 层 基 础 设施 ， 容 器 化 使 得 这 一 目 治 特性 更 加 明显 。 因 此 ， 容 器 化 
使 微服 务 变 得 与 云 无 关 。 

本 章 将 介绍 微服 务 的 容器 化 部 区 ， 以 及 虚拟 机 镜像 等 概念 。 读 者 将 了 解 到 如 何 针对 
微服 务 构建 Docker 镜像 ， 并 利用 Spring Boot 和 Spring 进行 开发 。 除 此 之 外 ， 我 们 还 将 
探讨 如 何在 准 生 产 环境 中 部 署 Docker 镜像 ， 以 及 如 何 管 理 和 维护 这 一 类 镜像 。 

在 阅读 完 本 章 后 ， 读 者 将 能 够 较 好 地 理解 容 占 化 机 制 ， 以 及 如 何 利 用 Spring Boot 和 
Spring Cloud 开发 容器 化 的 微服 务 。 

本 章 主 要 涉及 以 下 内 容 : 

”介绍 微服 务 染 构 中 的 容 右 。 

Docker 简介 。 

Spring Boot 应 用 程序 的 Docker 化 。 
编写 Dockerfile。 

使 用 docker-compose。 

编写 docker-compose 文件 。 

利用 docker-compose 进行 编排 。 
Kubernetes 简介 。 

利用 Kubernetes 进行 编排 。 

下 面 将 对 此 加 以 逐一 讨论 。 
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12.1 微服 务 架 构 的 容器 


微服 务 架构 是 开发 分 布 式 应 用 程序 的 另 一 种 方案 ， 该 方案 适用 于 现代 云 应 用 程序 的 
敏捷 性 、 伸 缩 性 以 及 可 靠 性 等 需求 条 件 。 如 前 所 述 ， 微 服务 应 用 程序 可 分 解 为 独立 的 组 
件 ， 并 可 协同 工作 实现 整体 系统 。 

在 微服 务 体系 结构 中 ， 可 以 独立 地 扩展 特定 的 功能 ， 而 不 是 盲目 地 扩展 应 用 程序 的 
其 他 领域 。 因此， 我 们 可 针对 特定 的 微服 务 扩展 资源 ， 如 处 理 能 力 和 网 络 带 宽 。 但 是 ， 
与 男 一 个 微服 务 共享 的 基础 设施 将 面临 什么 样 的 问题 ? 本 章 将 对 此 加 以 讨论 。 相 应 地 ， 
容器 化 解决 了 微服 务 间 共享 基础 设施 方面 的 问题 ， 并 使 得 微服 务 更 具 自主 性 。 

容器 化 可 在 完全 隔离 的 环境 下 运行 微服 务 。 因 此 ， 根 据 容器 化 处 理 方案 ， 容 器 可 视 
作 一 个 工件 。 其 中 ， 微 服务 及 其 版 本 化 的 依赖 项 集合 以 及 环境 配置 ， 被 抽象 为 部 署 清单 
文件 。 容 器 中 涵盖 了 所 有 与 基础 设施 相关 的 依赖 关系 、 环 境 变量 和 配置 内 容 ， 并 作为 容 
器 镜像 而 被 封装 。 该 镜像 将 作为 一 个 单元 进行 测试 ， 并 部 署 至 主机 操作 系统 中 。 

容器 化 仅 是 微服 务 开发 和 部 署 的 另 一 种 解决 方案 ， 其 间 ， 容 器 处 于 隔离 状态 ， 并 可 
运行 镜像 实例 。 同 时 ， 该 镜像 包含 了 运行 应 用 程序 所 需 的 一 切 内 容 。 在 容器 中 ， 可 在 不 
使 用 另 一 个 容器 的 资源 或 主机 的 情况 下 运行 。 此 外 ， 我 们 还 可 整体 控制 容器 ， 进 而 通过 
CLI 创建 、 删 除 、 移 动 、 启 动 和 终止 容器 ， 如 Docker 客户 端 。 相 应 地 ， 容 器 之 间 还 可 通 
过 网 络 彼此 连接 。 因 此 ， 容 器 类 似 于 一 台 分 离 、 独 立 、 隔 离 的 物理 或 虚拟 机 。 

虽然 容器 看 似 是 一 台 物 理 或 虚拟 机 ， 但 其 所 采用 的 技术 和 概念 完全 不 同 于 虚拟 机 。 
尽管 容器 运行 操作 系统 ， 但 它 持 有 一 个 文件 系统 ， 并 能 通过 网 络 进行 访问 ， 就 像 虚拟 机 
一 样 。 图 12.1 显示 了 虚拟 机 的 示意 图 。 

在 图 12.1 中 ， 虚 拟 机 包含 了 当前 应 用 程序 、 所 需 依赖 关系 以 及 客户 操作 系统 ， 管 理 
程序 则 是 一 个 共享 和 管理 硬件 的 计算 机 软件 。 图 12.2 显示 了 容器 的 示意 图 。 

在 图 12.2 中 可 以 看 到 ， 容 器 包含 了 应 用 程序 及 其 所 需 的 依赖 项 。 与 虚拟 机 不 同 ， 容 
器 间 共 享 操作 系统 和 底层 基础 设施 ， 它 们 在 主机 操作 系统 上 作为 独立 进程 运行 。 由 于 容 
器 共享 资源 ， 所 以 比 虚拟 机 需要 更 少 的 资源 。 


12.1.1 虚拟 机 和 容器 


表 12.1 显示 了 虚拟 机 和 容器 之 间 的 差别 。 
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Virtual Machines 


App 1 App 2 App 3 


Guest OS Guest OS Guest OS 


App 1 App 2 App 3 


Bins/Libs Bins/Libs Bins/Libs 


Hypervisor 


Host Operating System 操作 系统 
基础 设施 
图 12.1 
表 12.1 
虚拟 机 容 器 
虚拟 机 包含 应 用 程序 、 所 需 的 依赖 关系 以 及 客 | 容器 包含 应 用 程序 以 及 所 需 的 依赖 关系 , 并 共享 操 
户 操作 系统 作 系 统 和 底层 基础 设施 
每 个 虚拟 机 包含 自身 的 客户 操作 系统 ， 因 而 需 | 由 于 容器 共享 资源 ， 因 而 占用 较 少 的 资源 ， 仅 包含 
要 更 多 资源 操作 系统 为 每 个 容器 提供 的 最 小 内 核 
管理 程序 管理 VM 和 环境 容器 引擎 管理 容器 
添加 针对 扩展 行为 的 特定 资源 通过 创建 另 一 个 镜像 容器 扩展 容器 
针对 相同 的 硬件 和 资源 ， 可 创建 少量 的 虚拟 机 | 针对 相同 的 硬件 和 资源 ， 可 创建 较 多 的 容器 
虚拟 机 虚拟 化 底层 硬件 容器 虚拟 化 底层 操作 系统 
| , oT NL EC? ES e H 
根据 客户 操作 系统 ,VM 可 占用 几 个 GB 的 空间 is nomcn m 
虚拟 机 一 般 适用 于 具有 较 高 安全 性 的 单 体 应 用 | 容器 更 倾向 于 基于 微服 务 的 应 用 程序 , 或 者 其 他 原 
程序 生 云 应 用 程序 ， 且 安全 性 并 不 是 主要 的 考查 方向 


从 表 12.1 中 可 以 看 到 ，VM 和 容 匿 间 彼 此 不 可 蔡 代 ， 因 而 可 根据 应 用 程序 需求 条 件 
和 应 用 程序 架构 选取 对 应 方案 。 
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12.12 ”容器 万 案 的 优点 


下 列 内 容 列 出 了 容 占 开 太 和 部 车 方案 的 优点 : 


口 面 辣 容器 的 方法 消除 了 不 一 致 的 环境 设置 带 来 的 挑战 性 问题 。 

Q “可 以 根据 需要 通过 实例 化 新 容器 来 快速 扩展 应 用 程序 。 

Q “在 操作 系统 上 只 需要 使 用 最 少 的 内 核 。 

Q ”取决 于 应 用 程序 需求 条 件 ， 可 针对 微服 务 创建 多 个 容器 。 

口 “可 方便 地 分 配 资源 ， 并 在 各 种 环境 下 处 理 和 运行 应 用 程序 。 

Q “容器 化 减少 了 应 用 程序 和 服务 的 开发 、 测 试 和 部 署 时 间 。 

口 ” 由 于 应 用 程序 运行 、 汕 试 和 生产 之 间 不 存在 者 别 ， 因 而 Bug 修复 和 跟踪 的 复杂 
度 有 所 降低 。 

口 ” 容 器 化 是 一 种 较为 经 济 的 解决 方案。 

Q ”针对 基于 微服 务 的 应 用 程序 ， 选 择 范 围 较 广 ， 如 Devops 和 持续 部 署 。 

口 “ 在 相似 的 场合 下 ， 可 复 用 容器 镜像 。 

ü “考虑 到 可 伸缩 性 ， 针 对 基于 云 的 弹性 应 用 程序 ， 容 器 是 一 类 较为 流行 的 解决 方 


采 。 容 右上 映 像 非 第 小 ， 不 需要 局 动 操作 系统 ;为 外 ， 局 动 和 关闭 所 需 的 时 间 也 
IRD o 
Exe A EAJAS Y NERIEEHOT SCRUSEAEEEST o RARER RARER, IHR 
也 存在 一 些 限制 ， 接 下 来 查看 该 方案 所 面临 的 一 些 缺 点 和 挑战 。 


12.1.3 面 回 容器 方案 的 缺点 


下 列 内 容 列 出 了 应 用 程序 开发 和 部 署 时 ， 面 向 容器 方案 的 一 些 缺点 : 

I “容器 仅 运行 于 Linux 操作 系统 。 

Q 在 部 署 和 网 络 连接 过 程 中 ， 容 器 化 方案 需要 额外 的 配置 内 容 。 因 此 ， 维 护 正确 
的 网 络 连接 可 能 颇具 技巧 性 。 

Q ”安全 性 也 是 面向 容器 方案 的 一 个 主要 问题 
并 且 具 有 根 访问 权限 。 

上 述 内 容 列 举 了 应 用 程序 开发 和 部 署 过 程 中 ， 面 向 容器 方案 的 一 些 缺 点 ， 接 下 来 将 

探讨 面向 容器 方案 的 核心 概念 。 
面向 容器 的 解决 方案 涵盖 以 下 核心 概念 
Q 容器 主机 ， 容器 主机 类 似 于 一 个 引擎 ， 可 运行 多 个 容器 ， 并 可 将 虚拟 机 配置 至 


容器 共享 内 核 和 主机 操作 系统 ， 
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答 主 容器 上 。 
D Wa: 表示 为 镜像 的 运行 实例 。 
DQ” 容器 镜像 : 应 用 程序 需要 运行 多 种 资源 ， 例 如 分 层 文 件 系统 、 操 作 系 统 和 配置 
内 容 。 容 右 镜 像 洱 六 了 应 用 程序 所 需 的 各 项 内 容 。 从 本 质 上 讲 ， 容 器 镜像 不 可 
更 改 ， 且 在 部 获 至 不 同 坏 境 时 不 可 修改 其 状态 。 
D “容器 OS 镜像 : 容器 OS 镜像 是 从 其 他 几 个 容器 镜像 创建 的 以 组 成 一 个 容器 。 同 
样 ， 它 也 不 能 被 修改 。 
D 容 絮 存储 库 : 用 于 存储 容器 镜像 及 其 所 关联 的 依赖 关系 。 每 次 创建 容器 镜像 时 ， 
都 可 以 使 用 它 作 为 本 地 存储 库 。 同 时 ， 在 容器 主机 上 还 可 多 次 复 用 此 类 镜像 。 
相应 地 ，Docker Hub 即 是 容 右 镜像 的 一 个 示例 ， 并 可 在 不 同 的 容器 主机 间 加 以 
使 用 。 
当 针 对 基于 微服 务 的 应 用 程序 及 用 容器 基础 设施 时 ， 上 述 内 容 简 要 介绍 了 相关 的 核 
心 概念 和 解决 方案 。 在 分 布 式 应 用 程序 的 开发 和 部 闭 过 程 中 ， 这 也 是 多 家 公司 第 采取 的 
RTR. HIER, Docker 即 是 此 类 方案 的 一 个 实现 示例 。 接 下 来 将 介绍 Docker 这 一 
人 


12.2 Docker 简介 


在 应 用 程序 的 开发 和 部 车 过 程 中 ， 前 述 内 容 介 绍 了 面 癌 容 堪 的 解决 方案 及 其 各 种 优 
点 。 对 于 容 右 化 机 制 ，Docker 容器 化 实现 和 软件 平台 之 一 。 鉴 于 Docker 的 流行 程度 ， 有 
些 时 候 , 容器 化 也 常 称 作 Docker 化 。Docker 是 一 款 开源 计算 机 程序 , 则 在 通过 容器 创建 、 
部 车 和 运行 应 用 程序 。 容 器 允许 开 上 友人 员 对 应 用 程序 的 所 有 不 同 部 分 进行 划分 ， 例 如 库 、 
依赖 关系 和 异常 ， 并 于 随后 将 其 以 数据 包 的 形式 进行 存储 。 尽 管 应 用 程序 所 在 机 器 及 其 
测试 机 器 间 的 设置 发 生 了 变化 ， 容 器 化 处 理 过 程 可 确保 应 用 程序 在 任何 一 台 Linux 机 器 
EA. 

考虑 到 开源 特性 ， 还 可 对 Docker 进行 操控 ， 以 使 其 可 满足 任何 特定 用 户 的 需求 。 其 
间 ， 任 何人 均 可 对 此 做 出 应 有 的 页 献 ， 以 使 其 更 加 适用 ， 或 者 改进 其 需求 条 件 ， 并 添加 
不 同 的 特性 。 

Docker 最 初 针 对 Linux 操作 系统 而 开 友 ， 并 利用 了 Linux 内 核 的 隔离 特性 ， 例 如 内 
核 的 分 组 和 名 称 空间 。Linux 中 可 用 的 文件 系统 ， 如 OverlayFS， 人 允许 不 同 的 容器 在 单个 
Linux 实例 中 运行 ， 而 不 再 承担 虚拟 机 的 设置 、 安 装 和 维护 的 开销 。Docker 在 某 种 程度 上 
可 以 理解 为 虚拟 机 ， 但 与 VM 不 同 ，Docker 不 创建 整个 虚拟 操作 系统 。 实 际 上 ，Docker 
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允许 应 用 程序 使 用 机 器 的 内 核 ， 仪 提供 机 器 中 未 钾 涉 及 的 应 用 程序 需求。 在 为 应 用 程序 
握 供 较 好 的 执行 环境 的 同时 ，Docker 还 使 得 性 能 得 到 了 时 闭 的 提升， 并 减少 了 应 用 程序 
主 用 的 内 存 空 间 。 

作为 一 种 软件 工具 ，Docker 不 仅 适 用 于 开发 人 员 ， 同 样 也 对 系统 管理 员 有 效 ， 这 也 
使 得 它 成 为 DevOps 工具 链 的 一 部 分 内 容 。Docker 使 得 开 友 人员 更 关注 于 编码 ， 而 不 必 
担心 代码 是 否 可 运行 于 特定 的 系统 上 ;， 系统 管理 员 则 不 必 担 心 系统 规范 ， 因 为 Docker fb 
许 应 用 程序 在 任何 系统 上 运行 。 另 外 ， 由 于 Docker 占用 的 空间 较 小 且 开 销 较 低 ， 因 而 提 
供 了 较 好 的 灵活 性 ， 同 时 还 进一步 降低 了 所 需 的 系统 数量 。 

针对 执行 于 共享 环境 下 的 应 用 程序 ，Docker 还 提供 了 一 定 的 安全 保障 ， 但 容器 并 不 
能 替代 应 用 程序 所 需 的 安全 措施 。 如 果 Docker 并 未 在 多 方 共享 的 系统 上 运行 ， 并 且 机 器 
己 经 针对 容器 采取 了 良好 的 安全 实践 措施 ， 那 么 Docker 的 安全 性 就 不 再 是 所 关注 的 主要 
问题 。 一 些 人 还 把 Docker 误 认 为 是 虚拟 机 的 蔡 代 品 ， 但 事实 并 非 如 此 。 


12.2.1 安装 Docker 


如 前 所 述 ，Docker 软件 平台 可 用 于 构建 、 发 布 和 运行 轻 量 级 容器 ， 此 类 容器 均 基 于 
Linux 内 核 。 因 此 ，Docker 默认 状态 下 支持 Linux 平台 。 但 通过 运行 于 VirtualBox 之 上 的 
Toolbox, Docker 同样 支持 macOS 和 Windows 环境 。 

除 此 之 外 ，Docker 还 支持 云 平 台 ， 如 Amazon Web Service CAWS) 、Microsoft Azure 
和 IBM Cloud. Amazon EC2 Container Service (ECS) 则 对 AWS EC2 实例 上 的 Docker 
提供 了 更 加 直接 的 文 持 。 第 14 章 将 对 云 平 台 上 的 部 车 加 以 讨论 。 


12.2.2 Æ Linux 上 安装 Docker 


在 Linux 机 器 上 安装 最 新 版 本 的 Docker 时 ， 需 要 执行 以 下 步骤 。 
(1) 通过 下 列 命 令 更 新 apt £12: 51 : 


S sudo apt-get update 


(2) 在 更 新 了 apt 包 后 ， 通 过 下 列 命令 即 可 局 用 docker-engine ZITTE: 


S sudo apt-get install docker-engine 


(3) 上 述 命令 将 在 Linux 机 器 上 安装 Docker。 下 列 命 令 将 司 动 Docker 守护 进程 : 


$ sudo service docker start 


(4) 通过 下 列 命 令 ， 可 对 机 器 上 的 Docker 进行 测试 : 
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sudo docker run hello-world 


通过 运行 hello-world 镜像 ， 上 述 命令 将 验证 Docker 是 否 正 确 安 装 。 该 命令 下 载 一 个 
测试 镜像 并 在 容器 中 运行 。 图 12.3 显示 了 执行 上 述 命令 后 的 输出 结果 。 


docker run hello-vorld 


Hello from Docker? 
This message shows that your installation appears to be working correctly. 


lo generate this message, Docker took the following steps: 
1. Ihe Docker client contacted the Docker daemon. 

: LOS POE MET daemon pulled the "hello-vorld" image from the Docker Hub. 
am 

. Ihe Docker daemon created a new container from that image which runs the 
executable that produces the output you are currently reading. 

. Ihe Docker daemon streamed that output to the Docker client, which sent it 
to your terminal. 


| i a a 
lo try something more ambitious. you can run an Ubuntu container with: 
$ docker run -it ubuntu bash 


图 12.3 
12.2.3 Æ Windows 中 安装 Docker 


本 方 考查 如 何在 Windows 环境 下 安装 Docker。 对 此 ， 首 先 需要 从 https://download. 
docker.com/win/stable/Docker9620for?o20Windows9620Installer.exe 中 下 载 Docker, iZzhkk 
针对 于 Windows 10。 对 于 Windows 8， 则 需 态 问 https://download.docker.com/win/stable/ 
DockerToolbox.exe 并 下 载 Docker Toolbox， 并 于 随后 双击 安 逆 程序 进行 安 疼 。 在 Docker 
Toolbox 安 冯 完毕 后 ， 将 回应 用 程序 文件 光 中 分 别 浦 加 Docker Toolbox. VirtualBox 和 
Kinematics F Hina Docker Toolbox 并 运行 一 个 商 单 的 Docker 命令 。 在 成 功 地 安 沪 
了 Docker Toolbox 后 ， 果 和 面 上 将 显示 如 图 12.4 所 示 的 图 标 。 


n e| e| 


Oracle VM Docker Kinematic 
VirtualBox Quickst... (Alpha) 


图 12.4 
图 12.4 所 示 的 3 个 图 标 可 验证 Docker Toolbox 的 安装 结果 。 单 击 Docker QuickStart 
将 司 动 预 配 置 的 Docker Toolbox 终 凯 ， 随 后 可 看 到 配置 和 局 动 后 的 Dockers K| 12.5 显示 
了 交互 式 Docker Shell. 
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Select MINGWO4:/c/Users/Dinesh.Rajput 


Starting "default'... 

Cdefault» Check network to re-create if needed... 

Cdefault» Windows might ask for the permission to configure a dhcp server. Somet 
imes, such confirmation window is minimized in the taskbar. 

XCdefault» Waiting for an IP... 

Machine "default' was started. 

Maiting for 55H to be available... 

Detecting the prouisioner... 

Started machines may have new IP addresses. You may need to re-run the '"docker-m 
achine env command. 

Regenerate TLS machine certs? Warning: this is irreversible. Cyrn: Regeneratin 
uy ILS certificates 

Waiting for SS5H to be available... 

Detecting the provisioner... 

Copying certs to the local machine directory... 

Copying certs to the remote machine... 

Setting Docker configuration on the remote daemon... 


ad 
HH HH HH 
H HH 


UN 


is configured to use the machine with IP 1 
For help getting started. check out the docs at https:/^/docs.docker.com 


Start interactive shell 


图 12.5 


Be POKER] EIRA mHE MU. f$ docker version 命令 并 检测 Docker 的 版 本 ， 如 


色 12.6 所 示 。 


docker version 

lient: 

Uersion: 17.18.H-ce 

API version: 1.33 

Go version: qo1.8.3 

G1t commit : f4ffadz2b5 

Built: Tue Oct 17 19:00:02 2801" 
O05 /"frch: uindous^/amdb4 


eruer: 

Uersion: 17.11.H-ce 

API version: 1.34 &minimum version 1.12» 
Go version: 6g01.8.5 

Git commit: icaf"75c 

Built: Mon Nou 20 18:39:28 21" 

OS /lrch: |». linux^/amd64 

Experimental: false 


图 12.6 
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1. Docker 命令 


表 122 列 出 了 较为 利用 的 Docker 命令 。 


表 12.2 
w Ho 述 
— Wf HET PR PUR IE GS TT TIG dA 其 中 包含 ID, £ 
称 、 基 本 镜像 名 称 和 端口 转发 等 信息 
该 命令 针对 容 右 生成 一 个 定义 ， 并 可 以 在 Docker HEX 
docker build 


件 中 使 用 此 命令 创建 新 的 容器 定义 

可 使 用 该 命令 从 Docker 存储 库 中 获取 Docker 镜像 (通过 
远程 或 本 地 存储 库 方 式 ) 

根据 本 地 或 远程 容器 定义 ， 该 命令 负责 启动 一 个 Docker 


docker pull [image name] 


docker run pen 
容器 
| 该 命令 可 用 于 癌 Docker 存储 库 中 发 布 应 用 程序 的 Docker 
docker push 


容器 ， 如 DockerHub 


2. 特定 于 容器 的 命令 
这 一 类 特定 于 容器 的 命令 将 使 用 容器 ID 或 容器 名 称 作 为 参数 ， 如 表 12.3 所 示 。 


表 12.3 

D F o X 
docker stats [container name/ID] [container | PEH iZ mA wa ERR RARS. Man CPU Hr 
name/ID] 比 、 内 存 应 用 状态 以 及 网 络 流量 
docker logs [-f] [container name/ID] 该 命令 将 显示 日 期 的 日 志 输 出 。 此 外 ， 还 可 使 用 下 选项 
docker inspect [container name/ID] 该 命令 将 所 有 配置 信息 以 JSON fito e hi S T ds P 
docker port [container name/ID 该 命令 用 于 显示 容器 主机 和 容器 间 所 有 有 效 的 转 友 端口 
docker exec [-1] [-t] [container name/ID] 可 以 使 用 该 命令 针对 目标 容 右 执行 命令 


12.24 Docker 架构 


Docker 基于 客户 问 - 服 务 嚣 架构， 其 中 包含 了 以 下 3 个 主要 的 组 件 : 
Q Docker 4€ J tii o 

Q Docker 守护 进程 。 

Q Docker 仓库 。 

12.7 显示 了 Docker 架构 的 示意 图 。 
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DOCKER. HOST 


docker build .. | Docker daemon 


docker pull - | 


docker run 


图 12.7 


O Docker 客户 端 : 表示 为 一 个 接口 〈CLI) 以 执行 Docker 命令 ， 如 构建 、 运 行 和 
终止 命令 。Docker 客户 站 将 与 Docker 守护 进程 服务 器 进行 交互 。 除 此 之 外 ， 还 
可 利用 远程 Docker 守护 进程 连接 Docker 客户 六。 这 将 使 用 REST API 并 通过 
Unix 套 接 字 或 网 络 接口 构建 Docker 和 Docker 服务 器 间 的 通信 。 
D Docker 守护 进程 : 表示 为 运行 于 后 台 的 一 个 进程 ， 可 监听 Docker API 的 全 部 请 
求 ， 同 时 还 可 管理 Docker 对 象 ， 如 镜像 、 容 器 、 网 络 和 容量 。 
Q Docker 仓库 : 该 组 件 采 用 公有 或 私有 方式 存储 Docker 镜像 。Docker Hub 和 
Docker Cloud 可 视 为 公有 Docker 仓库 的 示例 。 任 何人 均 可 使 用 此 类 型 的 仓库 。 
Docker 数据 中 心 (DDC) 和 Docker 受信 仓库 (DTR) 则 是 私有 Docker 仓库 的 
示例 。 
O Docker 主机 : 表示 为 运行 应 用 程序 所 需 的 完整 的 Docker 环境 。Docker 主机 提供 
了 Docker 镜像 、 容 器 和 Docker 守护 进程 服务 器 。 
Q Docker 镜像 : 表示 为 不 可 改变 的 Docker 对 象 一 一 一 旦 创建 ， 便 无 法 对 其 进行 
修改 。Docker 镜像 是 Docker 架构 的 核心 组 件 之 一 ， 并 涵盖 了 运行 应 用 程序 所 
需 的 全 部 资源 ， 例 如 操作 系统 和 库 。 在 创建 完毕 后 ， 可 在 任意 Docker 平台 上 
运行 。 
例如 , 在 Spring Boot 微服 务 中 , HE RAI RIRE Caccumulated package; 如 Ubuntu, 
Alpine, JRE 以 及 Spring Boot 应 用 程序 的 JAR 文件 ) 均 为 Docker 镜像 。 图 12.8 显示 了 
Docker 镜像 的 示意 图 。 
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Spring Boot 
Application Jar 


Operating System 


图 12.8 


可 以 看 到 ， 其 中 包 侣 了 Spring Boot MHIE JAR, JRE 和 操作 系统 〈 如 Ubuntu) , 
并 可 运行 于 任何 Docker 机 井中 。 

当 丛 看 本 地 有 效 的 镜像 列表 时 ， 可 使 用 docker images 命令 ， 访 命令 的 输出 结果 如 
图 12.9 所 示 。 


$ docker images 
REPOSITORY TRG IMAGE ID 
mongo latest 5b1317f8158f 3 weeks ago 
doj/customer latest 22BeBdcb?f197 months ago 
| MITTIT ahbie42eH4H4 months ago 
<none> G7c71085177f months ago 
latest J8fabab9c67"7 months ago 
{none > 480369 abðlae months auo 
{none > c'?d612c2'795d months ago 
months ago 
months auo 


doj/accounts-microservuice latest 32892183e1aH 
doi^/discoueru latest 48e2f 0487814 


Gal Ga la G C Ga la CJ | 


图 12.9 


图 12.9 显示 了 包含 诸如 REPOSITORY、TAG、Image ID. CREATED. SIZE 等 信息 
的 Docker 镜像 列表 。 其 中 ，REPOSITORY 表示 为 Docker 镜像 的 本 地 存储 库 名 称 ; TAG 
表示 Docker 镜像 的 版 本 ; IMAGE ID RIRN Docker 镜像 的 唯一 标识 符 。 接 下 来 讨论 另 一 
个 Docker 架构 组 件 。 


12.2.5 Docker 引擎 


Docker 5| ER 7g — ^2 P Ym- Hi aM HIET, HEENA FEH: 
UO FIGE., BARS ATE 111 843511. 

LU REST RZZO, HFS FI EENE ERATES . 

D 命令 行 界面 (CLI) XP iho 
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图 12.10 显示 了 Docker 引擎 的 示意 图 。 


Client 


docker CLI | 
| data volumes 
REST AP! 


server 
docker daemon 


图 12.10 


可 以 看 到 ，Docker CLI 表示 为 管理 容器 、 镜 像 、 网 络 和 数据 容量 的 客户 端 。Docker 
客户 端 使 用 REST API 与 服务 器 进行 交互 ， 同 时 它 也 是 一 个 Docker 守护 进程 。 


12.26 Docker 容器 


Docker 容器 表示 为 Docker 镜像 的 运行 实例 。Docker 提供 了 CLI 命令 以 运行 、 局 动 、 
终止 、 移 动 或 删除 一 个 容器 。 我 们 可 以 在 容器 中 设置 环境 变量 并 针对 网 络 提供 相关 配置 。 
容 占 将 获得 其 上 自 号 的 网 络 配 置 和 文件 系统 。 男 外 ， 每 个 容器 进程 明 过 内 核 特性 (Docker 
在 运行 期 内 提供 ) 包含 目 身 的 独立 进程 空间 。Docker 容器 在 运行 期 使 用 答 主 操作 系统 的 
内 核 ， 它 们 与 运行 在 同一 操作 系统 主机 上 的 其 他 容器 共享 主机 内 核 。 即 使 容器 是 从 相同 
的 Docker 映像 启动 的 ， 它 们 也 拥有 自己 特定 的 资源 分 配 ， 如 内 存 和 CPU。 

图 12.11 显示 了 Docker 容器 的 示意 图 。 

可 以 看 到 ，Docker 引擎 负责 管理 Docker 容器 ，Docker 容器 则 是 Docker 镜像 的 运行 
实例 ， 其 中 包含 了 应 用 程序 和 相关 库 的 依赖 关系 。 
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CONTAINER 


App A App B App C 
Bins/Libs Bins/Libs Bins/Libs 
Docker 
Host OS 


Infrastructure 


图 12.11 


Fri £8 nfsr A Docker 镜像 中 创建 一 个 Docker 容器 ， 相 天 命令 如 下 所 示 : 

S docker run hello-world 

上 述 命令 包含 以 下 3 部 分 内 容 。 

D docker: 表示 为 Docker 引擎 ， 并 用 于 运行 Docker 程序 。 同 时 ， 还 将 通知 操作 系 

统 当前 正在 运行 Docker 程序 。 

OD run: 用 于 创建 和 运行 Docker Zi. 

D hello-world: 表示 为 镜像 名 称 。 我 们 需要 指定 加 载 至 当前 容器 中 的 镜像 名 称 。 

如 前 所 述 ， 每 个 容 需 包含 了 目 喘 的 资源 副本 ， 例 如 符 主 操作 系统 内 核 、RAM 和 文件 
系统 。 这 里 的 问题 是 , 如 何 对 此 进行 处 理 ? 相应 地 , 我 们 可 通过 Dockerfile 执行 相关 操作 。 
接 下 来 将 讨论 如 何 创建 Dockerfile. 


12.2.7 编写 Dockerfile 


Dockerfile 有 时 也 称 作 Docker build 文件 ， 它 是 一 个 简单 的 文本 文件 ， 其 中 包含 了 一 
组 命令 ， 并 在 镜像 创建 时 被 调用 。 同 时 ，Dockerfile 还 实现 了 Docker 镜像 生成 过 程 中 的 
目 动 化 处 理 。 相 应 地 ，Dockerfile 命令 几乎 等 同 于 其 对 等 的 Linux 命令 。 因 此 ， 对 于 这 一 
构建 文件 来 说 ， 并 不 存在 额外 的 语法 内 容 ， 我 们 可 方便 地 生成 目 己 的 Dockerfile， 进 而 构 
££ Docker 容器 。 

Docker 使 用 Dockerfile 构建 Docker 镜像 ,并 可 定义 全 部 所 需 的 依赖 关系 和 相关 步骤 ， 
以 在 容器 内 运行 Docker 镜像 。 另 外 ， 资 源 的 访问 方式 ， 例 如 存储 和 网 络 接口 ， 也 可 定义 
于 Dockerfile 中 。 此 外 ， 还 可 在 该 环境 中 利用 Dockerfile 虚拟 化 磁盘 驱动 顺 。 在 这 一 
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Dockerfile 中 定义 的 所 有 资源 均 隔 离 于 容器 外 部 。 但 是 ， 我 们 也 可 定义 相应 的 应 用 程序 端 
口 ， 并 在 容 苍 外 部 对 其 加 以 访问 。 

在 Dockerfile 创建 完毕 后 ,可 将 充 文 件 置 于 应 用 程序 目 了 未 中, 下面 在 文本 编辑 规 中 创 
建 一 个 空 文件 ， 并 将 其 保存 全 应 用 程序 目 采 中 。 接 下 来 讨论 编写 Dockerfile 时 的 各 项 操作 
步 又。 

首先 利用 vim 命令 创建 一 个 文件 ， 并 将 其 保存 为 Dockerfileg。 需 要 注意 的 是 ， 对 应 的 
文件 名 须 为 包 信 大 与 D 的 Dockerfile。 

下 列 代 码 将 Dockerfile 指令 写 入 Dockerfile 中 : 


#This is a Dockerfile for a microservice application 


# Use an official Java 8 runtime as a parent image 
FROM openjdk:8-jdk-alpine 


HSet maintainer email id 
MAINTAINER adminGédineshonjava.com 


# Set the working directory to /app 
WORKDIR /app 


# Copy the current directory contents into the container at /app 
ADD . /app 


# Install any needed packages libraries 
RUN mvn clean install 


# Build and create jar using maven command 
RUN mvn package 


# Make port 80 available to the world outside this container 
EXPOSE 80 


HK Define environment variable 
ENV JAVA OPTSz"" 


# Run accounts-microservice.jar when the container launches 
CMD ["java SJAVA OPTS -Djava.security.egd-file:/dev/./urandom -jar 
accounts-microservice.jar", "accounts-microservice.Jjar"] 


可 以 看 到 ， 上 述 Dockerfile 包含 了 一 些 指令 ， 进 而 创建 Docker 镜像 和 容器 。 在 
Dockerfile 中 ， 需 要 注意 以 下 几 点 内 容 : 
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O MLF Dockerfile 中 的 指令 均 为 大 小 写 敏 感 ， 这 也 表明 , 没有 必要 在 特定 情况 下 编 
写 命令 ， 但 必须 遵守 相关 约定 并 使 用 大 写字 母 。 

Q Docker 遵循 和 目 上 而 下 的 顺序 运行 Dockerfile 中 的 指令 。Dockerfile 的 第 一 条 指 应 
为 FROM， 并 指定 基础 镜像 。 在 当前 示例 中 ， 将 根据 openjdk:8-jdk-alpine 镜像 
创建 一 个 镜像 。 

LU f£ EX Dockerfile 中 ， 以 “#” 开 始 的 语句 表示 为 注释 ， 如 “#This is a Dockerfile 
for a microservice application”。 其 他 指令 则 可 用 于 Dockerfile F, 如 RUN, CMDs 
FROM, EXPOSE 和 ENV. 

D “下 一 条 指令 表示 维护 该 镜像 的 相关 人 员 。 此 处 指定 了 MAINTAINER 关键 字 , 并 
设置 了 对 应 的 电子 邮件 ID。 

口 “ 可 采用 WORKDIR 并 针对 RUN 和 CMD 设置 工作 目录 ， 随 后 则 是 COPY 指令 。 

如 果 不 存 在 工作 目录 ,， 则 该 目录 将 在 默认 状态 下 被 创建 。 在 Dockerfile 中 ， 该 命 

令 可 被 多 次 使 用 。 

ADD 命令 用 于 将 当前 目录 内 容 复 制 全 /app 处 的 容 堪 中 。 

RUN 命令 用 于 运行 指令 (针对 当前 镜像 〉。 在 当前 示例 中 ， 第 一 个 RUN 命令 

用 于 运行 mn 命令 ， 并 安装 、 清 除 微服 务 应 用 程序 中 的 数据 包 库 ; 第 二 条 RUN 

命令 则 通过 运行 mvn package 这 一 maven 命令 创建 JAR 文件 。 

Dockerfile 的 EXPOSE 45-9 fi ids P BBHJAm L1 80 可 用 。 

ENV 命令 用 于 针对 微服 务 应 用 程序 定义 环境 变量 。 

最 后 一 个 CMD 命令 将 通过 当前 镜像 执行 微服 务 应 用 程序 。 

保存 Dockerfileg。 稍 后 ， 我 们 还 将 讨论 如 何 利用 Spring Boot 应 用 程序 构建 镜像 。 
在 通过 相关 指令 创建 了 Dockerfile 后 ， 根 据 应 用 程序 的 需求 条 件 ，Dockerfile WiK ri 

了 其 他 指令 。 考 虑 到 全 部 指令 均 较 为 简单 且 易 于 编写 ， 因 而 这 里 并 不 打算 对 其 进行 过 多 

的 描述 。docker build 命令 将 针对 构建 指令 查找 Dockerfile。 接 下 来 讨论 如 何 创建 Spring 

Boot 应 用 程序 并 对 其 实现 Docker 化 。 


LL 


LDLLL 


12.3 Docker 化 Spring Boot 应 用 程 厅 


本 而 主要 讨论 如 何 实 现 Spring Boot 应 用 程序 (Account-Service) 的 Docker 化 ， 并 在 
隔离 的 容器 环境 中 运行 该 程序 。 前 述 章节 曾 创 建 了 某 些微 服务 ， 例 如 Account-Service 和 
Customer-Service， 下 面 将 介绍 如 何 将 Spring Boot Account-Service 迁移 至 Docker H. X} 
此 ， 首 先 需 要 修改 构造 文件 ， 随 后 将 创建 Dockerfile 以 使 程序 能 在 本 地 运行 。 
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下 面 在 Spring Boot 项 目 中 创建 Dockerfile, 4i P Pr: 


#This is a Dockerfile for a microservice application 


# Use an official Java 8 runtime as a parent image 
FROM maven:3.5-jdk-8-alpine 


VOLUME /tmp 


HSet maintainer email id 
MAINTAINER adminG8àdineshonjava.com 


# Set the working directory to /app 
WORKDIR /app 


# Copy the current directory contents into the container at /app 
ADD . /app 


# Build and create jar using maven command 
#RUN mvn package -DskipTests-true -Ddir-app 


# Copy the current directory contents into the container at /app 
ADD target/account-service-0.0.1-SNAPSHOT.jar accounts-microservice.Jjar 


# Make port 80 available to the world outside this container 
EXPOSE 80 


# Define environment variable 
ENV JAVA OPTSz"" 


# Run accounts-microservice.jar when the container launches 
ENTRYPOINT [ "sh", "-c", "java S$JAVA OPTS - 
Djava.security.egd-file:/dev/./urandom -jar accounts-microservice. jar" ] 


EIÑ Dockerfile PERNE, 但 包含 了 运行 Spring Boot 应 用 程序 所 需 的 全 部 内 容 ; 
同时 还 利用 maven 命令 mvn package 生成 了 一 个 JAR 文件 。 随 后 ， 项 目 JAR 文件 作为 
accounts-microservice.jar 被 添加 全 容器 中 ， 进 而 在 ENTRYPOINT 中 被 执行 。 

图 12.12 显示 了 相应 的 应 用 程序 目录 结构 。 

不 难 发 现 ，Dockerfile 被 置 于 某 个 目录 中 ， 并 与 pom.xml 文件 并 列 放 置 。 接 下 来 通过 
下 列 命 令 创建 一 个 Docker 镜像 。 


$ docker build -t spring-boot-app . 
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> Chapter-12-account-service-docker [boot] | 


> src/main/Java 


> com.dineshonjava.accountservice 
com.dineshonjava.accountservice.controller 
- com.dineshonjava.accountservice.domain 
; > com.dineshonjava.accountservice.repository 
> src/main/resources 
F> > src/test/Java 
ah JRE System Library [JavaSE 
, Maven Dependencies 
» SIC 
7, target 
; Dockerfile 
; mvnw 
S mvnw.cmd 
|" pom.xml 


图 12.12 
其 中 ，spring-boot-app 表示 为 镜像 名 。 AR, 我 们 可 对 Docker & f v BAT AER. 
上 述 命令 将 从 Dockerfile 中 构建 镜像 ， 对 此 ， 我 们 需要 指定 Dockerfile 路 径 。 在 上 述 命令 
中 ， n 47 , XRH Dockerfile 位 于 当前 工作 目录 中 。 
万 外 ，- 选项 用 于 标 合 操作 ， 进 而 标记 新 的 镜像 ， 随 后 则 是 相应 的 版 本 亏 ， 如 下 所 示 。 


S docker build -t spring-boot-app:1.0.1 . 


上 述 命令 的 输出 结果 如 图 12.13 所 示 。 


5 docker build -t spring-boot-app . 
Sending build context to Docker daemon  52.62HMB 
Step 1/79 : FROM mauen:3.5—-jdk-S-alpine 
——»5 H88'798c3343de 
Step 2/9 : UOLUME /tmp 
——» Using cache 
———5 [b547dld/ee'"eHe 
Step 3/9 : MAINTAINER adminldineshonjava.com 
——» Using cache 
一 一 一 六 173eae5492f2 
Step 4^9 : WORKDIR zapp 
——5» Using cache 
———5» g2bb5ecelHabd4/ 
Step 5/9 : ADD . “app 
———5 313bh94He2"765e 
Step 5/9 : ADD target/account-seruice-H.H.1-SMBPSHOT.;jar accounts-microservuice.;jar 
———» 777351389215 
Step 7^9 : ESPOSE 8H 
———5» Running in 4H3e55725e4a 
emouing intermediate container 44H3e55725e4a 
一 一 一 六 25c4ee521ehb 
Step 8/9 : ENU JAVA OPTS-''"' 
———5»* Running in 4c8dBHai1H2447 
emouing intermediate container 4c8dBHalB2447 
一 一 一 六 fe716b26H7ad 
Step 97/9 : ENTRYPOINT [ "sh", "-c", "java $JüUAR OPTS -Djava.security.eugd-file:/deu/.^/urandom —j 
——5» Running in 3358B86d93dc2 
Removing intermediate container 3358864093dc2 
——25» d51fH378674H 
Successfully built d5i1fW83i/55974H 
Successfully tagged spring-boot-app-:latest 


图 12.13 
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从 图 12.13 中 可 以 看 出 ， Docker 镜像 已 被 成 功 地 创建 ， 随后 即 可 利用 docker run 命令 
运行 Docker 镜像 。 下 列 命 令 用 于 运行 spring-boot-app。 


S docker run -p 8080:8080 spring-boot-app:latest 


上 述 docker run 命令 将 运行 创建 了 spring-boot-app Docker 镜像 后 的 容器 ， 对 应 结果 
如 图 12.14 所 示 。 


- docker run -p 8080:8080 spring-boot-app:latest 


-* Spring Boot : (v2.8.8. RELEASE) 


2818-84-H9 21:35:56.637 INFO 5 -— I main] c.d.a. flccountSeruiceflpplication 

£ 434208 with PID 5 &/app/accounts-microseruice.jar started by root in /app? 

2018- HW4-H9 21:35:56.049? INFO 5 一 -一 I mainl c.d.a.HccountSeruiceHpplication 

ault 

2018-84-89 21:35:56.857 INFO 5 —- I mainl GConfigSeruletVebSeruerfipplicationGontext 
二 startup date [Mon fpr 89? 21:35:56 GMT 2 
2818-84-89 21:35:88.654 INFO 5 一 -一 [ main] trationDelegate$BeanPostProcessorChecker 
ctionManagementConfiguration' of type [org.springframevork.transaction.annotation.ProxyTIransact 
s not eligible for getting processed by all BeanPostProcessors for example: not eligible for a 
2818- 84-H9 21:36:01.705 INFO 5 -— I main] o.s.b.v.enbedded.tomcat.TomcatlebServer 
2818-84-89 21:36:01.895 INFO 5 -— [ nain] o.apache.catalina.core.Standard$Service 
2W815-B4-H? 21:356:H1.8805 INFO 5 一 一 上 mainl org.apache.catalina.core.StandardEbngine 
2818- 84-89 21:36:81.845 INFO 5 一 -一 I[ost-startStop-11] o.a.catalina.core.fipeLifecucleListener 
nal performance in production environments was not found on the java.library.path: L[^/usr^/lib^/jv 
open jdk/ jre/lib/amd64: CHE RU IU gne". 1.8-openjdk/^/jre/../lib/amd64:/usr/java/packages/lib^/amd 
2018- 84-89 21:36:02.092 INFO 5 一 一 一 [ost-startS5top-1] o0.a.c.c.GC.I[Tomcat ].Llocalhostl. Lz] 

2018- 84-89 21:36:02.093 INFO 5 —-- [ost-start$top-il o.s.weh.context .ContextLoader 


图 12.14 


通过 观察 可 知 ，Account-Service 已 被 成 功 地 运行 。 在 运行 了 spring-boot-app 后 ， 通 
过 访问 下 列 URL, 29 WEZ ARCEECEDU V, sis Hp JI EA Si 7] o 


http://197.168.99. 100:B080/account 


对 应 结果 如 图 12.15 所 示 。 

图 12.15 显示 了 访问 自 H2 DB 的 数据 ,前 述 章 节 曾 对 此 有 所 讨论 .当前 ,ACCOUNT- 
SERVICE 微服 务 已 被 Docker 化 ,并 作为 一 个 Docker Wall d CEN EE 
表示 为 于 外 部 访问 的 容器 IP, 8080 则 表示 为 这 一 特定 容器 的 端口 。 

前 述 内 容 创 建 了 一 个 微服 务 ， 并 通过 docker build 命令 将 其 构建 为 Docker 镜像 。 除 
此 之 外 ， 还 可 利用 Maven 或 Gradle 生成 Docker 镜像 ， 接 下 来 将 对 此 加 以 讨论 。 
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g 192.168.99.100:8080/ac- x$ W 


C | © 192.168.99.100:8080/ac 


accountId: 400, 
balance: 4502.92, 
customerId: 1000, 
accountType: “SAVING” 
branchCode: "HDFCO86" 
bank: "HDFC" 


accountId: 500, 
balance: 5502.92, 
customerId: 2000, 
accountType: "SAVING" 
branchCode: "ICICO06", 
bank: "ICICI" 


accountId: 6688, 
balance: 6502.92, 
customerId: 3000, 
accountType: "CURRENT", 
branchCode: "SBIBOGO6", 
bank: "SBIB" 


图 12.15 


12.4 利用 Maven 创建 Docker 镜像 


如 前 所 述 ，Maven 可 用 于 处 理 依 赖 关 系 ， 并 通过 加 Maven 配置 文件 pom.xml 中 添加 
某 些 插 件 ， 进 而 支持 某 个 程序 版 本 的 构建 。 因 此 ， 如 果 和 希望 通过 Maven 命令 创建 Docker 
镜像 ， 则 需要 在 Maven pom.xml 文件 中 添加 新 的 插件 。 考 得 下 列 代码 : 


«properties» 


«docker.image.prefix»doj«/docker.image.prefix» 


«/properties» 


«build» 
«plugins» 
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«plugin» 
«groupId»com.spotify«/groupId» 
«artifactlId»dockerfile-maven-pluginc/artifactlId» 
«version»1.3.4«/version» 
«configuration-» 
«repository»S[docker.image.prefix])/S[íprojJect.artifactlId]«/repository» 
«buildArgs-» 
«JAR FILE»target/S$[project.build.finalName].jar«/JAR FILE» 
«/buildArgs» 
«/configuration» 


«/plugin» 


T T 
«/build» 
EIÑ Maven pom.xml 文件 利用 com.spotify 和 ockerfile-maven-plugin 配置 了 新 的 插件 ， 
其 中 涵 震 了 以 下 两 项 配置 : 
D ”包含 镜像 名 的 存储 库 ， 此 处 为 doj/accountaccount-service。 
UO JAR 文件 名 ， 并 作为 Docker 构建 参数 公开 了 Maven 配置 。 
下 面 使 用 Maven 命令 构建 Douckker 镜像 ， 如 下 有 所 示 : 


S ./mvnw install dockerfile:build 


另外 ， 利 用 下 列 命 令 可 将 Docker 镜像 置 入 Docker Hub 中 


./mvnw dockerfile:push 


类 似 地 ， 还 可 利用 Grade 构建 命令 ， 即 通过 Gradle 构建 Docker 镜像 。 
接 下 来 将 讨论 Docker Compose. 


12.5 Docker Compose 向 介 


Docker Compose 是 一 个 Docker 工具 ， 并 可 作为 单一 服务 运行 多 个 容器 。 例如 ， 如 果 

某 个 应 用 程序 需要 使 用 到 ACCOUNT-SERVICE 和 CUSTOMER-SERVICE， 因 而 仅 生 成 
单一 文件 即 可 ， 这 可 用 作 单 一 服务 启动 、 终 止 容器 ， 且 无 须 分 别 对 其 予以 启动 和 终止 。 
本 节 将 介绍 Docker Compose 及 其 局 动 方式 。 随 后 将 讨论 如 何 获 得 包含 CCOUNT- 
SERVICE 和 CUSTOMER-SERVICE 的 单一 服务 ， 并 通过 Docker Compose 加 以 运 
如 前 所 述 ,每 个 独立 容器 均 包 含 自 叶 的 Docker 命令 和 特定 的 Dockerfile. iz — 
适用 于 创建 各 自 的 容器 。 但 是 企业 系统 不 是 一 个 单独 的 容器 ， 它 必须 包含 多 个 容器 才能 
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在 独立 的 应 用 程序 网 络 上 操作 ， 人 否则 容器 管理 将 很 快 变 得 混乱 。 

Docker Compose 可 利用 目 己 的 YAML 格式 的 文件 来 解决 这 一 问题 , 这 对 于 管理 多 个 
容 需 来 说 更 加 适用 。 例 如 ， 它 能 够 在 一 个 命令 中 局 动 或 停止 服务 组 合 ， 或 者 将 多 个 服务 
的 日 志 记 录 输 出 合并 到 一 个 pseudo-tty 中 。 对 于 开发 、 测 试 和 登台 (staging) 环境 来 说 ， 
Docker Compose 均 古 一 蒜 优 郁 的 工具 。 接 下 来 讨论 如 何在 机 器 上 安装 Docker Compose. 


12.5.1 安装 Docker Compose 


OrchardUp FÈ f —3X4473 Fig 的 工具 ， 可 使 阳 离 的 开发 环境 与 Docker 协同 工作 。 
Fig ŒA A ir 3k fna f dz Docker Inc. 所 收购 ， 因 而 现在 更 名 为 Docker Compose. Docker 
Compose 可 分 别 在 macOS, Windows 和 Linux 环境 下 安装 。 

在 Windows 和 Mac 环境 下 ，Docker Toolbox 已 配置 了 Compose 连同 其 他 Docjker M 
用 程序 。 因 此 ， 我 们 需要 单独 安装 Docker Compose. 

在 Linux 环境 下 ， 可 访问 GitHub 上 的 Compose 存储 库 发 布 页 面 ， 进 而 下 载 Docker 
Compose 二 进 制 文件 。 根 据 链 接 中 的 指令， 其 则 和 圾 要 运行 curl 命令 下 载 二 进 制 文件 ， 随 
后 可 遵循 相关 指令 进行 操作 。 

运行 下 列 命 令 安 逆 最 新 版 本 的 Docker Compose: 

sudo curl -L 


https: //github.com/docker/compose/releases/download/1.21.0/docker-compose-S$ 
(uname -s)-S(uname -m) -o /usr/local/bin/docker-compose 


针对 二 进 制 文件 应 用 执行 权限 ， 如 下 所 未 : 


sudo chmod +x /usr/local/bin/docker-compose 


接 下 来 对 安装 结果 进行 测试 ， 如 图 12.16 所 示 。 


$ docker-compose —-uersion 


docker-compose version 1.16.1, build 6diac21" 


图 12.16 


在 Docker Compose HREM,  h— 2» Wl EHEH Docker Compose, LAX t fn] 2g 
与 docker-compose.yml 文件 。 

下 面 创建 运行 于 不 同 Docker 容器 中 的 两 个 微服 务 应 用 程序 示例 ， 此 次 服务 间 可 彼此 
通信 ,并 作为 单一 应 用 程序 单元 出 现 于 条 主 系统 中 。 因 此 , 此 处 将 创建 Account 4H Customer 
服务 ， 如 图 12.17 所 示 。 
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bọ docker ps 
CONTAINER ID IMAGE PORTS NAMES 


d26f d178Ue4e doj^/customer-seruice 8181^/tcp. H8.H.8.8:8282-»6B86H8/^tcp dreamy einstein 
R286caf99fba doj^/account—-seruice gB88H/tcp. H.8.50.8:8181-»686HB^tcp cocky. thomnpson 
1£97ede49F98 do;j^/eureka-servuer H.H.8.8:8B88B8-»8761^tcp ecstatic jepsen 


[&] 12.17 


当前 , 存在 3 "I 4E 233511 44 7J doj/account-service. doj/constomer-service 和 doj/eureka- 
server 的 镜像 。 下 面 考查 如 何 使 用 Docker Compose。 对 此 ， 读 者 可 访问 GitHub 以 获取 全 
部 服务 的 完整 示例 代码 ， 对 应 网 址 为 https:Wgithub.com/PacktPublishing/Mastering-Spring- 
Boot-2.0. 

我 们 的 目标 是 作为 单一 隔离 系统 运行 此 类 服务 ， 而 不 是 分 别 运 行 3 个 独立 的 容器 。 
利用 单一 命令 ，Docker Compose 可 作为 单一 隅 离 系 统 运行 此 类 服务 。 接 下 来 讨论 如 何 使 
用 Docker Compose。 


12.5.2 ”使 用 Docker Compose 


Docker Compose Zj FEH, AA LU. CAR IURMS3TAIEE: 
C12 利用 Docker Compose 定义 服务 环境 ， 因 而 它 可 以 在 任何 地 方 重建 。 
(2) 在 定义 了 微服 务 后 〈 在 docker-compose.yml 文件 中 用 作 单 一 应 用 程序 ) ， 通 过 
docker-compose.yml 文件 ， 可 在 一 个 隔离 的 系统 中 共 Wiper 
(3) 执行 docker-compose up, Compose 可 局 动 、 运 行 全 部 应 用 程序 
接 下 来 ， 我 们 将 讨论 Docker Compose 文件 。 


12.5.3 ”编写 docker-compose 文件 


Docker Compose 文件 是 一 个 简单 的 YAML 格式 文件 , 其 中 包含 了 与 隔离 系统 相关 的 
多 条 指令 eoi Agi get 。 除 此 之 外 ， 还 可 定义 每 个 容器 的 环境 。 通 过 一 
条 命令 ， 可 局 动 或 终止 服务 组 合 。 典 型 的 docker-compose.yml 文件 如 下 所 示 : 


version: "2" 
services: 
eureka: 
image: doj/eureka-server 
ports: 
- "8080:8761" 
account: 
image: doj/account-service 
ports: 
- "8181:6060" 
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links: 
- eureka 


customer: 


image: doj/customer-service 
ports: 

- "8282:6060" 
links: 

- eureka 

- account 


上 述 docker-compose.yml 文件 格式 包含 了 简单 的 yml 格式 。 下 面 进一步 得 看 文件 中 


的 具体 合 


n" 


LLL 


EKRA], version 定义 了 Docker Compose XFIRE. V^ Ex AP n] Be 
fE[H] —2X 3], services 定义 了 服务 的 数量 ， 如 account. customer 和 eureka. 
每 项 服务 再 要 一 个 镜像 运行 Docker 容 堪 ， 因 而 此 处 添加 了 额外 的 image 参数 。 
image 关键 字 针 对 eureka, account 和 customer 服务 用 于 指定 Docker Hub 中 的 镜像 : 
> 对 于 eureka， 仅 需 引 用 Docker Hub 上 的 doj/eureka-server 镜像 。 

> XF account， 引 用 Docker Hub 上 的 doj/account-service 镜像 。 

> ”对 于 customer， 引 用 Docker Hub 上 的 doj/customer-service 镜像 。 

ports 关键 字 指 定 了 需要 公开 于 eureka, account 和 customer 服务 的 端口 : 

> 对 于 eureka， 我 们 公开 8080:8761 临 口 ， 并 可 于 外 部 对 其 进行 访问 。 

> 对 于 account， 我 们 公开 了 8181:6060 端口 ， 并 可 于 外 部 对 其 进行 访问 。 

> 对 于 customer， 我 们 公开 了 8282:6060 端口 ， 并 可 于 外 部 对 其 进行 访问 。 
除 此 之 外 ， 我 们 还 针对 account 和 customer 指定 了 1links 变量 ， 并 以 此 创建 当前 
服务 和 下 列 服 务 间 的 内 部 链接 : 

> R eureka 服务 的 account 服务 链接 。 

> 包含 eureka 和 account 服务 的 customer 服务 链接 。 


下 面 利 用 新 版 本 清空 原来 处 于 运行 状态 下 的 容器 ， 并 采用 docker stop «container ID> 
命令 终止 原来 的 运行 容 右 ， 如 图 12.18 所 示 。 


5 docker stop 8d26fdi7Be4e S82G6caf99fha if9?ede49f98 
Sd26f di178Ue4e 


B206caf 99f ba 
1f97?ede49f 78 


图 12.18 


在 终止 了 原来 的 运行 容器 后 ， 可 利用 下 列 命令 对 其 进行 检测 : 


S docker ps 
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对 应 的 输出 结果 如 图 12.19 所 示 。 


上 docke 


ps 
CONTAINER I D HAGE COMMAND CREÀTED TAIUS 


图 12.19 


在 企业 级 应 用 程序 中 ， 一 般 会 运行 几 十 个 或 几 白 个 服务 ， 仪 运行 3 个 服务 这 种 情况 
XS ds IPIE. DUC, E HEX 义 些 容器 并 确保 所 有 不 同 的 MA ITERAR BE e PI X E R ASAE 
— Docker Compose 的 出 现 使 得 多 个 容器 间 的 组 织 工 作 变 得 相对 简单。 
一 处 理 过 程 也 称 作 容 帮 的 编排 或 运行 。 接 下 来 讨论 基于 docker-compose 的 编排 操 
作 ， pe Docker Compose 示例 。 


12.5.4 基于 docker-compose 文件 的 编排 操作 


在 Docker Compose 文件 中 ， 经 适当 定义 后 可 形成 一 组 容 娠 ， 这 也 赴 一 个 YAML 配 
A XIF. HJE], docker-compose 通过 正确 的 选项 和 配置 项 管理 容 亏 的 运行 期 配置 。 表 述 
内 容 曾 创建 了 docker-compose.yml 文件 ， 下 和 面 过 过 下 列 命 令 并 针对 语法 错误 测试 该 文件 
的 配置 内 容 。 


$ docker-compose config 


对 应 的 输出 结果 如 图 12.20 所 示 。 


$ docker-compose config 
: yanl.parser.ParserError: while parsing a block mapping 
| in ".*docker-compose.uml'"., line 1. column 


expected Xblock end», but found '-' 
in ".*docker-compose.uml". line 18. column 1 


图 12.20 


图 12.21 针对 语法 错误 显示 了 相关 结果 。 


» docker-compose config 
services: 
account : 
image: doj/account-seruice 
links 
— eureka 


ports: 
一 8181-:6B86H^tcp 
customer: 
image: doj/customer-seruice 


links: 
— eureka 


— account 


ports: 
一 8282: 6B6H^tcp 
eureka: 
Image: do j^/eureka-server 


por 
- S080: 2 dpt AER 


ers lon: 


图 12.21 
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vi ims 
o EA: 


应 位 于 docker-compose.yml 文件 所 处 的 目录 中 ， 以 便 可 执行 大 多 数 Compose 命令 。 
最 后 ， 可 利用 下 列 一 条 命令 启动 Docker Compose. 


S docker-compose up -d 


上 述 命 令 的 对 应 输出 结果 如 图 12.22 所 示 。 


$ docker-compose up -d 
| ing network "dockercompose default'" with the default driver 
ing dockercompose eureka 1 ... 
dockercompose eureka 1 .. 
| dockercompose, account 1 . 
dockercompose account 1 
| dockercompose customer 1 
Creating dockercompose customer 1 


p 
一 一 


由 于 使 用 了-d 选项 ， bx 述 命 令 以 分 离 模式 运行 容器 。 相应 地 ， 退 过 下 列 命 人 令 可 检 测 | 
容器 的 状态 。 


S docker-compose ps 


图 12.23 显示 了 对 应 的 输出 结果 。 


docker-compose ps 
Command 


aüockercompose account 1 sh -c java $JAUAR OPTS -Dja ... .H:8181—»5B56H/tcp. SHBSH/tcp 
ockercompose, customer, 1 sh -c java $JfUA OPTS -Dja ... | .0:8282-5»6BH6H^tcp. 8181^tcp 
ockercompose eureka 1 sh -c java $JAUAR OPTS -Dja ... | .8:8888-»8'761/^tcp 


图 12.23 


a UEF, HRS SUCAMIJSÍI. MIEN WW asHWIHABAXHJURL. a AEdA4T 
一 步 测试 。 
Ei ZGAH] http://192.168.99.100:8181/account/101 测试 account-service, 对 应 数据 如 图 12.24 
所 示 。 


09 rd DD 可 和 站 本 本 上 
(D 192.168,99.100 


accountId: 
balance: 
customerId: 


accountType: 
branchCode: ^ 
bank: "ICICI" 


图 12.24 


* 246 * 精通 Spring Boot 2.0 


接 下 来 通过 http://192.168.99.100:8282/customer/1001 测试 customer-service, 对 应 的 数 
据 如 图 12.25 所 示 。 


customerId: 1001, 
customerName : 


mobile: 
email: 


city: 
- account: 


Fr 
L 


accountlId: 101 
balance: 3502.9 
customerId: 
accountType: 
branchCode: 
bank: "ICICI" 


accountId: 2600, 
balance: 3122.05, 
customerId: 1001, 
accountType: "CURRENT", 
branchCode: "HDFCO02", 
bank: "HDFC" 


图 12.25 


利用 下 列 命 令 可 终止 处 于 运行 状态 下 的 服务 。 


S docker-compose down 


对 应 的 输出 结果 如 图 12.26 所 示 。 


2 docker-compose down 

otopping dockercompose customer 1 
Stopping dockercompose account 1 
Stopping dockercompose eureka 1 


Removing dockercompose customer 1 
Removing dockercompose. account 1 
Removing dockercompose eureka 1 c 
Removing network dockercompose default 


图 12.26 
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通过 下 列 命 令 可 特定 服务 的 容器 。 
S docker-compose scale [compose container name]-3 


考 合 下 列 示 例 : 


S docker-compose scale account=3 
对 应 的 输出 结果 如 图 12.27 所 示 。 


: docker -compose scale account = 
MARN - Ihe scale command is deprecated. Use the up command with the ——-scale flag instead. 
dockercompose account 1 ... 
y dockercompose account 2 ... 
dockercompose account 3 ... 
dockercompose account 2 ... 
dockercompose. account, 3 ... 


Command 


dockercompose account. 1 s] java JRUN OPTS -Dja kc 8BSB/tcp 
ockercompose. account, 2 java SJAVA_OPTS -Dja ... 8HSH^tcp 
dockercompose account, 3 = java SJAVA_OPTS -Dja ... S8HSH^tcp 


lockercompose customer 1 s] java $JRUR OPTS -Dja ... WH.H.H.H:828Z2—»6H6H^tcp. 8181/tcp 
dlockercompose eureka 1 | java $JAUAR OPTS -Dja ... 8.8.8.8:88880—5»8761^/tcp 


图 12.27 


通过 观察 可 知 ， 当 前 账 己 容器 包含 了 3 个 实例 。 但 此 处 存在 一 个 问题 : 鉴于 端口 发 
生变 化 ， 客 户 问 如何 调 用 account-service 的 实例 ? 

针对 这 一 问题 ， 存 在 一 些 解 决 方案 可 对 其 加 以 处 理 ， 如 Kubernetes 和 AWS ECS. fH 
后 将 讨论 Kubernetes， 第 14 WKAR AWS ECS 的 部 着 操作 。 

此 处 采用 一 家 名 为 Tutum 的 公司 握 供 的 一 种 简洁 方案 ， 即 HAProxy 扩展 。 访 代理 可 
根据 链接 的 容 右 实现 目 壬 的 目 动 配置 ， 并 可 针对 多 个 容 右 用 作 人 负载 平衡 占 。 下 面 通过 添 
加 下 列 与 tttum/haproxy 镜像 相关 的 配置 项 ， 进 而 更 新 docker-compose.yml 文件 。 

version: "2" 

services: 

eureka: 
image: doj/eureka-server 
ports: 
— "8080:8761" 


account: 
image: doj/account-service 
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links: 
- eureka 
customer: 
image: doj/customer-service 
ports: 
- "8282:6060" 
links: 
- eureka 
— account 
ha account: 
image: tutum/haproxy 
links: 
- account 
ports: 
— n8181:80" 


Bim 17514 8) ££ € ^l account-service A) (ARRAES m) »— PLACER RENT 
account 服务 移 除 了 静态 端口 配置 。 默 认 状 态 下 ， 通 过 在 3 个 运行 实例 间 使 用 轮 询 算法 ， 
HAProxy Docker 容器 可 视 为 一 个 负载 平衡 器 。 

接 下 来 讨论 另 一 种 Docker 容器 编排 工具 Kubernetes. 


12.6 Kubernetes 向 介 


Kubernetes 是 一 个 可 移植 的 开源 平台 , 用 于 管理 容器 化 的 应 用 程序 和 服务 ， 以 及 改进 
应 用 程序 的 配置 和 目 动 化 。 目 前，Kubernetes 正 处 于 快速 发 展 中 ， 并 针对 大 众 提供 了 相应 
的 支持 、 服 务 和 工具 。 

Kubernetes 是 谷歌 推出 的 一 个 项 目 ， 并 于 2014 年 实现 了 开源 。 谷 歌 拥 有 数 十 年 的 大 
规模 负载 处 理 经 验 , 在 此 基础 上 , Kubernetes 还 采纳 了 社区 提供 的 一 些 优秀 理念 和 最 佳 实 

Kubernetes 可 与 多 种 不 同 的 工具 协同 工作 ， 包 括 Docker, tm tl AHH He. TE 
作 和 目 动 化 提供 了 一 个 容器 化 的 应 用 程序 平台 。 

Joe Beda, Brendan Burns 和 Craig McLuckie 5 tR tn y Kubernetes, 随后 , Brian Grant 
和 Tim Hockin 也 加 入 其 中 ,谷歌 的 Borg 系统 对 Kubernetes 的 设计 和 开发 影 啊 较 大 一 一 一 
些 优秀 的 页 献 者 首先 参与 Borg 项 目 。 

2015 年 ， 谷 歌 发 布 了 Kubernetes v1.0， 同 时 还 与 Linux 基金 会 合作 ， 成 立 了 云 原 生 
计算 基金 会 (CNCF) 。 


第 12 章 微服 务 的 容器 化 。249 。 


Kubernetes 包含 以 下 一 些 特性 : 

I REFR- 

口 ” 微 服务 平 合 。 

D 可 迁移 的 云 平 人 台 。 

Kubernetes 平台 的 主要 目标 是 文 持 与 容器 相关 的 管理 环境 。Kubermetes 在 不 同 的 基础 
设施 之 间 提 供 了 可 移植 性 、 简 洁 性 和 灵活 性 ， 并 在 某 种 程度 上 模拟 了 Paas 和 Iaas。 
Kubernetes 配置 了 多 种 功能 ; 同时 ,该 平台 的 开源 特性 也 使 其 能 够 不 断 予 以 改进 ， 并 问 系 
统 中 添加 新 功能 。 

这 个 定期 更 新 的 系统 也 使 得 Kubernetes 逐步 演化 为 一 个 平台 ， 进 而 形成 一 个 组 件 和 
工具 生态 系统 ， 以 便 部 署 、 扩 展 和 管理 应 用 程序 ， 同 时 也 使 得 程序 更 易 处 理 。 

Kubernetes 的 设计 人 允许 在 其 上 构建 许多 不 同 的 系统 ,标签 允许 用 户 根 据 目 己 的 需要 组 
织 资 源 ， 而 注解 则 为 用 户 提 供 了 目 定 义 资 源 和 相关 信息 ， 以 适应 其 工作 流 并 对 所 使 用 的 
工具 进行 管理 。 

构建 Kubernetes 控制 平面 的 API 对 开发 人 员 和 用 户 也 是 可 用 的 ， 因 此 ， 用 户 可 以 构 
建 目 己 定制 的 控件 和 API， 以 供 CL 工具 所 用 ， 并 根据 开发 人 员 的 需求 进行 操作 。 

尽管 Kubernetes 包含 了 诸多 强大 的 功能 ， 但 它 仍然 不 足以 成 为 Paas 系统 的 蔡 代 品 。 
考虑 到 诸多 相似 性 ， 因 而 可 以 这 样 理解 Kubernetes: 它 为 部 署 、 扩 展 、 记 录 和 监视 应 用 程 
序 提供 了 一 个 平台 。Kubernetes 上 则 在 通过 其 工作 负载 和 数据 处 理 支 持 各 种 不 同 的 应 用 程 
序 。 但 是 ， 只 有 容器 化 的 应 用 程序 才能 在 Kubernetes 平台 上 运行 良好 。 
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户 可 以 在 任何 Docker 平台 上 运行 容器 。 基 于 容器 的 方法 已 经 被 许多 企业 所 采用 ， 其 受 欢 
迎 程度 与 日 俱 增 。 

基于 容器 的 虚拟 化 对 于 微服 务 体 系 结 构 来 说 是 一 个 更 好 的 解决 方案 ， 其 中 ， 应 用 程 
序 特性 被 划分 为 较 小 的 、 定 义 民 好 的 、 独 特 的 服务 。 容 器 和 VM 不 是 相互 独立 的 ， 它 们 可 
以 看 作 是 互补 的 解决 方案 。Netflix Cloud 就 是 一 个 很 好 的 例子 ， 其 中 容器 运行 于 虚拟 机 上 。 

另外 ， 本 质 还 介绍 了 Docker Compose。 利 用 Docker Compose, PAFI TET 
中 运行 一 次 性 命令 ， 甚 至 可 扩展 容器 的 数量 。 

第 13 章 将 讨论 和 实现 Swagger 和 KONG API 管理 器 。 
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本 章 将 讨论 分 布 式 系统 中 的 API 管理 器 .设置 KONG 开源 API 管理 器 、 在 KONG API 
管理 器 中 配置 API 端点 、 针 对 API 标准 的 Swagger， 以 及 基于 KONG 的 速率 限制 和 日 志 
HLI 

在 前 述 章 节 中 ， 我 们 学 习 了 容器 架构 及 其 优点 和 所 面临 的 挑战 。 除 此 之 外 ， 我 们 还 
创建 了 Docker 容器 ， 并 在 Docker XA LI Account 和 Customer 微服 务 。 本 章 将 讨 
wW API 管理 和 相关 工具 ， 如 Swagger 和 KONG。 其 间 ， 我 们 将 通过 Spring. Spring Boor 
和 Spring Cloud 并 使 用 到 相关 的 微服 务 系统 示例 。 

在 阅读 完 本 章 后 ， 读 者 将 能 够 较 好 地 理解 KONG 和 Swagger， 以 及 如 何 使 用 这 些 工 
HX} REST API 进行 管理 和 文档 化 。 

本 章 主要 涉及 以 下 主题 : 

D ”API 管理 。 

Q ”速率 限制 。 

Qd KONG. 

Qd Swagger. 

下 面 将 逐一 对 此 加 以 讨论 。 


13.1 API 管理 


API 管理 是 一 种 客户 端 外 部 的 API 管理 机 制 ， 例 如 通过 限 流 或 速率 限制 控制 API 的 
访问 。 其中， EEERESIEDS API 的 特定 使 用 者 控制 访问 行为 。 例 如 ， lie jin 100 
次 请 求 使 用 特定 的 API。 通过 速率 限制 控制 API 访问 ,API 管理 工具 可 帮助 我 们 获得 一 
HJD Sz f e 

API 管理 工具 可 有 效 地 控制 API 的 管理 复杂 度 。 众 所 周知 ,API 应 用 在 当前 市 场 中 呈 
上 升 势 头 ， 大 量 的 业务 均 与 API 有 关 。 因 此 ，API 管理 对 于 API 提供 商 来 说 变 得 十 分 重 
要 。 男 外 ，API 开发 过 程 与 API 管理 截然 不 同 。 

如 果 希 望 正确 地 使 用 API， 那 么 ， 强 大 的 文档 机 制 同样 十 分 重要 。 男 外 ，API 管理 的 
其 他 参数 也 需要 引起 我 们 的 足够 重视 ， 例 如 安全 级 别 、 综 合 测 试 、 版 本 控制 和 高 可 靠 性 。 
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13.1.4 API 管理 软件 的 优点 


API 管理 工具 具有 以 下 优点 : 

监视 来 自 每 个 应 用 程序 的 流量 。 

控制 API 和 使 用 API 的 应 用 程序 间 的 连接 。 

管理 API 版 本 的 一 致 性 。 

提供 了 缓存 机 制 和 内 存 管 理 方案 ， 进 而 改善 应 用 程序 的 性 能 。 
提供 了 一 定 的 安全 措施 ， 防 止 API 受到 外 部 威胁 。 

下 面 将 对 多 家 API 管理 方案 供应 商 加 以 考查 。 


LDLDLLL 
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相应 地 ， 存 在 多 种 API 管理 工具 ， 下 列 内 容 列 出 了 较为 流行 的 几 种 API 管理 工具 。 
KONG. 
3scale API 管理 工具 。 
Akana 平台 。 
Apigee. 
Azure API 管理 。 
TIBCO Mashery. 
MuleSoft. 
WSO2. 
AE. 53h Web 服务 API 网 天。 
下 面 讨论 API 管理 平台 中 较为 重要 的 一 项 功能 ， 从 安全 性 和 业务 角度 来 看 ， 该 功能 
十 分 重要 。 


LDLLLLLLLL 
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速率 限制 是 一 种 特定 的 计数 器 模式 ， 可 用 于 显示 所 执行 操作 的 速率 。 该 模式 的 典型 
实现 是 限制 针对 公共 API 执行 的 请 求 数量 。 

API 提供 者 针对 此 类 问题 提供 了 一 种 解决 方案 ， 即 速率 限制 。 速 率 限制 是 指 APT 出 
于 各 种 原因 拒绝 请 求 的 过 程 ， 其 间 涉及 过 多 的 并 发 连接 ， 以 及 面 对 大 量 数据 难以 令 人 满 
意 的 请 求 行为 。 通 过 实现 速率 限制 ， 开 发 人 员 实际 上 安装 了 一 个 “插口 ”， 调 整 这 一 “ 揪 
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口 ” 可 改变 系统 内 的 流量 。 实 现 速率 限制 的 另 一 个 原因 是 防止 拒绝 服务 (Dos) 攻击 。 
在 相对 安全 的 环境 中 ， 开 发 人 员 还 需要 考虑 到 系统 的 限制 问题 ， 例 如 防止 溢出 现象 。 
这 就 像 拥 挤 的 道路 常会 导致 拥堵 和 事故 一 样 ， 受 到 过 度 限 制 的 逻辑 连接 也 会 面临 同样 的 
问题 。 
从 业务 上 下 文 来 看 ，API 提供 者 可 将 速 认 限制 实现 为 一 种 利润 -成 本 抵消 拉 术 。 其 中 ， 
大 量 用 尸 付费 后 将 抵消 增加 的 运营 成 本 ， 从 而 转化 为 最 终 的 利润 。 
速率 限制 的 实现 包含 多 种 简单 而 直接 的 方案 ， 其 中 一 种 较为 前 见 的 方法 是 服务 左上 
的 内 部 绥 存 机 制 。 
太一 种 实现 方案 则 是 使 用 Redis， 并 通过 下 列 方式 使 用 速率 限制 模式 : 
FUNCTION LIMIT API CALL (ip) 
ts = CURRENT UNIX TIME () 
keyname = ip-t":"-ts 
current z GET (keyname) 
IF current != NULL AND current > 10 THEN 
ERROR "too many requests per second" 
ELSE 
MULTI 
INCR (keyname, 1) 
EXPIRE (keyname, 10) 
EXEC 
PERFORM API CALL () 
END 


基本 上 讲 ， 此 处 在 每 个 卫 、 每 秒 的 基础 上 设置 一 个 计数 器 。 但 此 类 计数 器 一 般 呈 递增 
状态 ， 并 设置 10 秒 的 过 期 时 间 。 因 此 ， 奎 当前 秒 数 发 生变 化 ，Redis 将 移 除 这 些 计数 器 。 

此 外 ， 还 可 使 用 一 个 拦截 器 ， 并 针对 微服 务 项 目 中 的 API 实现 速率 限制 。 针 对 国定 
或 分 布 式 系统 ， 速 率 限 制 的 实现 过 程 可 采用 多 种 算法 。 相 应 地 ， 还 可 利用 KONG API 快 
速 地 针对 API 设置 速率 限制 。 

接 下 来 将 讨论 KONG API 管理 工具 。 


13.3 KONG 简介 


本 而 将 讨论 KONG， 首先 考 焉 下 列 引 文 : 
“对 于 NGINX 平台 上 的 API 实现 方案 ，KONG 可 简化 开发 的 复杂 度 并 减少 部 署 
时 间 。 
一 一 Owen Garrett, NGINX 产品 经 理 
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KONG 是 一 个 开源 的 可 扩展 API 层 ， 并 在 通过 持 件 扩展 的 RESTful API 之 前 运行 。 
通过 这 一 方式 ，KONG 提供 了 附加 功能 和 服务 ， 并 远 远 超出 了 核心 平台 所 提供 的 服务 。 

Mashape 构建 KONG 的 最 初 目 标 是 保护 、 管 理 、 扩 展 API 和 微服 务 〈 总 量 已 超过 
15000 ^) ， 以 此 满足 相关 API 市 场 的 需求 。 这 在 一 个 月 内 为 超过 20 万 的 开发 人 员 生 成 
了 数 十 亿 的 请 求 。 当 前 ，KONG API 已 被 应 用 于 规模 不 同 的 各 家 机 构 中 ， 进 而 部 署 关 键 
性 任务 。 

如 前 所 述 ，KONG 是 一 种 API 外 观 ， 同 时 也 是 一 个 RESTful API 前 端的 过 滤器 。 该 
网 天 提供 了 下 列 功能 项 。 

Q ”访问 控制 : 仅 支 持 经 身份 验证 和 授权 的 访问 。 
速率 限制 ， 限制 发 送 至 API 的 流量 。 
分 析 、 度 量 指标 和 日 志 机 制 : 跟踪 API 的 使 用 方式 。 
安全 性 过 滤 机 制 : 确保 进入 的 流量 不 是 攻击 行为 。 

Q EEN: 将 流量 发 送 至 不 同 的 新 点 处 。 

任何 客户 端 均 可 通过 KONG 调用 REST API， 这 将 向 REST 发 送 代理 客户 端 请 求 ， 
并 执行 针对 REST API 设置 的 所 有 功能 ， 例 如 所 安装 的 速率 限制 插件 。 在 调用 API ZL BU. 
KONG 还 将 检测 并 确保 请 求 数量 不 会 超出 所 指定 的 极限 值 。 图 13.1 显示 了 KONG 示意 图 。 


LLL 


CLIENT KONG SERVERS 


图 13.1 


AUASI, Ze m3 KONG 服务 器 调用 API. KONG 编排 了 和 常见 的 功能 ， 如 速 
紊 限制、 访问 控制 和 日 忘记 录 。 


13.3.1 基于 KONG 染 构 的 做 服务 REST API 


图 13.2 显示 了 与 KONG 架构 流程 相关 的 示意 图 。 

可 以 看 到 ，KONG 在 一 处 提供 了 集中 和 统一 的 功能 。KONG 体系 结构 是 分 布 式 的 ， 
可 以 通过 一 个 简单 的 命令 从 一 个 地 方 扩 展 功 能 。 用 户 可 方便 地 在 服务 器 问 配 置 KONG. 
而 无 需 在 微服 务 应 用 程序 级 别 进行 任何 修改 。 开 发 人 员 只 需要 关注 产品 自身 即 可 ， 且 无 
需 担心 API 管理 机 制 ，KONG 负责 管理 REST 事务 。 
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速率 限制 
缓存 


API 


业务 合作 者 。 业务 合作 者 


图 13.2 
13.3.2 未 采用 KONG 架构 的 APl 应 用 


KONG 工具 为 API 管理 机 制 提供 了 一 个 集中 的 解雇 方案。 如 果 在 服务 器 级 别 缺 少 API 
的 KONG 配置 ， 则 必须 跨 多 个 微服 务实 现 API 管理 的 公共 功能 。 这 意味 着 代码 的 重复 性 
将 会 增加 ， 并 且 很 难 在 不 影响 其 他 微服 务 的 情况 下 进行 维护 和 扩展 。 此 时 ， 系 统 趋同 于 
早 体 结构 ， 图 13.3 显示 了 缺少 KONG Bio EIPDELHI IRE- 

通用 功能 代码 分 布 在 API 之 间 ， 通 常 非常 难以 管理 。 除 了 业务 代码 之 外 ， 开 发 人 员 
还 负责 API 管理 。 接 下 来 我 们 将 了 解 如 何在 系统 上 安装 KONG. 


13.3.3 安装 KONG 


KONG 可 以 在 多 种 操作 环境 下 进行 安装 ， 同 时 也 包括 Docker 这 一 类 容器 。 本 节 将 讨 
论 如 何 通 过 Docker 安装 KONG. 
在 安装 KONG ZA, RF Docker 的 一 些 详细 信息 ， 旋 者 可 参考 种 12x. 
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速率 限制 速率 限制 


志 缓存 
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速率 限制 


业务 合作 者 业务 合作 者 


图 13.3 
此 处 将 使 用 DockerHub 存储 库 获 得 KONG 的 Docker 镜像 。 在 后 续 示 例 中 ， 我 们 将 
把 KONG Docker 容器 链接 至 Cassandra Docker 容器 上 ， 并 执行 下 列 操作 步 驿 : 
(1) 使 用 Cassandra 容器 存储 与 KONG API 相关 的 信息 。 对 此 ， 可 采用 如 图 13.4 所 
示 的 命令 。 


5 docker run -d —-name kong-database ^N 
-p 9042:9042 NÊ 


? Caszanüdra:-3 


图 13.4 


(2) 通过 如 图 13.5 所 示 的 命令 ， 使 用 KONG 容器 迁移 Cassandra 数据 库 。 
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S docker run —--rm * 

> —-link kong-database :kong-database ^ 
> —e "KOMG DAüHTRBRSE-cassandra"' * 
> 
> 
> 


—e "KONG_PG_HOST =kong-database" N | | 
-—e "KONG CAHSSANDRA  CONTRCT, POINTS-kong-database"' N 
kong: latest kong migrations up 


图 13.5 
3) JH] KONG. "il 13.6 所 示 。 


2 docker run -d --name kong 
| ——-link kong-databhbase: T ong: EOS ORE b 
"KONG DRATARBRSE-cassandra' 
"KONG PG HOST-koag database" ` 
"KONG CASSANDRA. GONTACT. POINTS-kong-database'' N 
"KONG PROZS"V ACCESS LOG-/deu/stdout' s 
"KONG ADMIN ACCESS LOG-/deu/stdout' N 
| "KONG. PROXV. ERROR LOG-/dev/stderr'" s 
"KONG ADMIM ERROR LOG-^/dev/stderr' s 
"KONG RADMIM LISTEH-H.8.80.00:8801"' N 
"KONG RDMIM LISTEH S5L-H.8.0.0:8444" * 
SHOH :8HBH s 
8443:8443 N 
; 888H1:8HBHB81 *. 
p 8444:8444 N 
kong: latest 


D 
amm 


图 13.6 


对 于 非 SSL 调用 ， 此 处 使 用 了 8080 端口 ， 而 端口 8443 则 用 于 SSL API 调用 ; 
8001 则 通过 RESTful Admin API 管理 KONG 安装 。 
(4) 验证 KONG 的 安装 结果 ， 如 图 13.7 所 示 。 


$ curl -i http-//192.168.99.188:8881^/ 
-1 200 OK 
: Fri. 28 fpr 2818 89:24:32 GMT 
Content-Type: application^/json; charset-utf-8G8 


lIransfer—-bncodingy: chunked 

penner i one keep-alive 

| s montro Hllowu-Origin: * 
: kong/BH.13.H8 


图 13.7 
这 里 访问 了 http:/192.168.99.100:8001/， 并 从 KONG API 中 返回 JSON 格式 的 数据 。 


13.3.4 使 用 KONG API 


在 Docker 中 安装 了 KONG 之 后 ， 下 面 将 使 用 KONG. API， 并 打算 向 使 用 者 公开 的 
REST API。 对 此 ， 和 需要 执行 下 列 步 又 : 
(1) Æ KONG 中 配置 服务 。 II KONG 后 ,可 在 8001 端口 上 使 用 Admin 
API 添加 新 服务 。 这 里 ， 服 务 表 示 公 开 了 API /微服 务 的 上 游 服务 器 。 考 查 下 列 命令 : 
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$ curl -i -X POST --url http://192.168.99.100:8001/services/ -- 
data 'name-account' --data 
'url-http://192.168.99.100:8181/account/ 


接 下 来 人 得 看 如 图 13.8 所 示 的 命令 。 


$ curl -i 一 X POST —url http:^/^/192.168.99.188:8HB1 ^seruices^l —üata 'name-accaount" —üata 'url-http:^/^/172.168.927.188:8181^account ^"' 
HTTPÁ/il.i 281 Created 
Date: Fri. 28 fipr 2818 09:56:01 GMT 


Content-Iwupe: 


图 13.8 


图 13.7 显示 了 上 述 命令 啊 应 后 的 输出 结果 。 在 浏览 器 中 访问 http//192.168.99.100:8001/ 
services， 对 应 输出 结 末 如 图 13.9 所 示 。 


host: "192.168.99,.100", 
created at: 1524218160, 


id: "ac44A3bbl-4A865-: zz" 
protocol: | 
name: “i 


port: 8181, 
path: "/ac 
updated at: 1524218160, 


— 


retries: 5, 


write timeout: 5080889 


图 13.9 


(22 YSI— JE ZSJT 2A BU HAS « NMRA 2e ROSE ARCU JI 7 B 7 SK 
进而 将 其 公开 至 客 己 六。 此 处 ， 路 由 控制 看 客户 新 请 求 针 对 服务 的 匹配 和 代理 方式 。 考 
E FIMA: 

curl -1i -X POST --urt 


http://192.168.99.100:8001/services/account/routes/ --data 
'hostzdineshonjava.com' 


对 应 输出 结 采 如 图 13.10 所 示 。 


78 13 章 API 管理 器 «259 。 


5 curl -1 -5 ail -—-url http:^//192.168.99.108:8HH1 ^seruices^laccount^routes./ -—üdata 'hostsll-2dineshonjaua.com' 
ITTP/^i.1 281 Created 
jate: Fri, 28 i2. 28018 18:19:14 GMT 
content= ype ap lic ation^/json; charset-utt-Uü 
ke 


a 
ranzsfer— Éncodi c hun 
nnus EE ede Eis vilius 
Hc - )1-Hllow-ürigin: * 
oeruer "kn ingi. 13.H 


c Ti n4, ts": ["dineshonjau gu als e."reqgex prioritu" :H,." 'upda RE 3242 19554, 
ebrii pe tags ond badd pp 5. tas 'inull."protac ios E "Aceh "https 19s Sdn ery Ao. 3583 2 75322" 


图 13.10 


运行 上 述 命令 后 即 可 添加 一 个 路 由 并 公开 当前 服务 。 
在 添加 了 代理 路 由 时 ， 在 浏览 器 中 访问 http://192.168.99.100:8001/services/account/ 
routes/， 并 查看 如 图 13.11 所 示 的 输出 结果 。 


created at: 1524219554, 
strip path: true, 
- hosts: 
"dineshonjava.com" 
ls 
preserve host: 
ii ca PPO 


service: 
id: "a: 


n 
js 


methods: 


protocols: 
http , 
1 https' 


F 


updated_at: 1524219554 


图 13.11 


图 13.11 显示 了 与 KONG "P Pris AUI AS TH AA EPI E. 
(3) MAF. 38i: KONG 插件 ， 可 添加 荣 些 附加 功能 项 。 上 此外， 我们 还 可 创建 
目 己 的 插件 ， 考 查 下 列 命 令 : 


curl -i -X POST --url http://192.168.99.100:8001/plugins/ -- 
data 'name-rate-limiting' --data 'service id-ac443bb1-4865-4f7aacde- 
1eb892357979' --data 'config.minute-z100' 


类 似 于 步骤 (1) ， 此 处 使 用 了 service id。 上 述 命令 的 输出 结果 如 图 13.12 所 示 。 
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curl -i -A POST * 
——url http:/7/172. 168.979. 188: CODD b" 
—-üata 'name-rate-limit ing 
'seruice id- ac443bb1 — À865-4f7a-acde-1eb892357979 、 
' conf iy.minute-1HH' 


Created 
Fri. 28 Apr 2818 18:12:13 GMT 
Content- Type: application/json; charset-utf-8 
Transfer-Encoding: chunked 
Connection: keep-alive 
ficcess—-Control-üllou-Origin: * 
Seruer: konq/HWH.13.H8 


图 13.12 


随后 ， 可 在 浏览 器 中 访问 http://192.168.99.100:8001/plugins/， 以 查看 速率 限制 插件 的 
设置 结果 ， 如 图 13.13 所 示 。 


created at: 
- config: i 

hide client headers: 
minute: 100, 
policy: "cluster ' , 
redis database: 0, 
redis timeout: 2000, 
redis port: 6379, 
limit by: "consumer" 
fault tolerant: true 

Ps 

id: 

service id: 

name: 

enabled: 


图 13.13 


利用 service id ac443bb1-4865-4f7a-acde-1eb892357979, 我 们 针对 当前 API 启用 了 速 
ADR rl UI BE o 

(4) RKA. Zw)? im H Bj n3 KONG Rs 上 游 的 APL 微 服务 ， 
默认 状态 下 运行 于 端口 8000 上 。 考 查 下 列 命 


curl -i -X GET --url http://192.168.99.100:8000/ --header 'Host: 
dineshonjava.com' 
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——-url http:^//1972.168.99.188:8888^ ——-header 'Host: 


dineshonjaua.con' 
Content-Type: application^/json;charset-UTF-8 
Transfer-Encoding: chunked 
onnection: keep-alive 
m—HateLimit-Limit-minute: des 
n-HRHateLimit-HRemaining-minut 99 
Date: Fri. 28 fpr 2818 10: TT -BA GMT 
mÉ—Kong-lpstream-Latencyu: i7 
n-Kong- Proxy-Latencyu: 254 
Uia: kong^/H.13.H 


LC" account Id "188. "balance":3582.32, "customerId":188M. "accountIype": SAUING . "branchCode" 
H1.'accountTupe"'': "SRUING", ,branchCode": "ICICIUB1 7. "bank": "ICICI "2 & "account Id 7:288, "balan 
P .bank": "HDFGC'"?,C"accountId":2B81,"balance" ":3122.85, "customerId":10604, "accountType": "CURRE 


."customerId':1882,"' 'accountTupe": "SAVING", "branchCode " : "HDFCB83" , "bank": "HDEC'? , £"accou 
Gode ' "IGIGIBB3", "bank": "IGIGI''? 1 


图 13.14 


这 将 利用 KONG 代理 路 由 返回 一 个 account 服务 啊 应 结果 。 类 似 地 ， 还 可 针对 该 
account 服务 在 KONG API 上 使 用 多 个 插件 。 下 列 命 令 将 添加 男 一 个 密 钥 号 份 验证 插件 : 


curl -i -X POST --url http://192.168.99.100:8001/plugins/ -- 
data 'name-key-auth' --data 'service id-ac443bb1-4865-4f7aacde- 
1eb892357979' 


在 图 13.15 中 可 以 看 到 ， 此 处 创建 了 当前 服务 所 用 的 授权 验证 密 钥 。 


25 curl -i http://19?2.168.929.188:8881^ 
HTTP^1.1 2808 OK 

Date: Fri. 2H Apr 2818 89:24:32 GHI 
Content-Type: application/json; charset-utf-8 
TIransfer-Encoding: chunked 

Connection: keep-alive 
filccess-Control-fillowv-Origin-: * 

oeruer: kong/BH.13.H 


图 13.15 


目前 ，key-auth 插件 已 被 添加 至 KONG API 中 ， 并 可 在 浏览 器 中 访问 http://192.168. 
99.100:8001/plugins/ 对 其 进行 检测 ， 如 图 13.16 所 示 。 
接 下 来 再 次 利用 KONG 代理 访问 当前 服务 ， 同 时 防止 因 缺 少 身 份 验 证 密 钥 而 调用 当 
前 服务 ， 如 图 13.17 所 示 。 
此 处 获得 一 条 401 响应 消息 : HTTP/1.1 401 Unauthorized. 
(5) 添加 使 用 痢 。 当 使 用 API 时 ， 我 们 需要 创建 一 个 使 用 痢 并 添加 密 钥 ， 如 下 所 示 : 


curl -X POST http://192.168.99.100:8001/consumers --data 
"username-dineshonjava" --data "custom id-1234" 


* 262 * 精通 Spring Boot 2.0 


created at: 1524221934673, 
- config: 1 
key in body: false, 
run on preflight: true, 
anonymous: ' , 
hide credentials: false, 


- key names: [ 


] 


P 
id: "4533fda9-84ae-4722-9cfe-858a63e 
service id: "ac443bb1-4865-4 

name: "key-auth" 

enabled: true 


图 13.16 


—url http://192.168.7?.158:8B8B8B^ —-header 'Host: dineshonjava.com' 


Date: Fri, 20 fpr 2818 11:84:41 GMT 
Content-Type: application^/json; charset-utf-8 
Transfer-Encodingy: chunked 

Connection: keep-alive 

AM-huthenticate: Key realm-"kong" 

Server: kong/BH.13.H 


&'message"-"Mo API key found in reqguest''? 


图 13.17 
图 13.18 5 f SU Bos 8 Hj e Jd 3 £i e 


Eon -A POST http:^//192.168.99.188:88B81^/consumers —-data "username-dineshonjava" ——d 


"custom id-1234" 


ata n Id 
"custom, id":"1234",. 'created at'':152422248219?'7,. "username": "dineshon java", "id": "976:8'7134-93897—4ca1-8648-f11a3£F21bb11"''? 


图 13.18 


在 浏览 器 中 访问 http://192.168.99.100:8001/consumers. 并 检测 针对 当前 服务 所 添加 的 
使 用 者 ， 如 图 13.19 所 示 。 

SH] 44 dineshonjava 和 ID 1234， 此 处 添加 了 一 个 使 用 者 。 随 后 ， 可 对 其 创建 一 
个 授权 验证 密 钥 。 下 面 通过 key-auth 使 用 当前 服务 ， 如 下 所 示 : 


S curl -X POST 
http://192.168.99.100:8001/consumers/dineshonjava/key-auth --data 


nw 
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custom id: "1234", 
created at: 1524222402197, 


username: "dineshonjava", 
id: "97c87134-9389-4cal-8648-f11a3f21bb11" 


图 13.19 


利用 http://192.168.99.100:8001/consumers/dineshonjava/key-auth f Jl 5 LIS ub E 4H, 
如 图 13.20 所 示 。 


id: "0249169c-73d6-45c8-95f2-5436c4ca333e" 


created at: 1524223092893, 


3 


key: "yyBFORSLDfaAb4Aks T9IqfHWwLOpVYbtG" , 
consumer id: "97c87134-9389-4cal-8648-f11a3f21bb11" 


图 13.20 


插件 自动 生成 一 个 密 钥 , 该 key 值 将 用 于 调用 API。 相 应 地 ,可 在 请 求 体 中 传递 这 一 
key {Ë ~ 

FARRA AT APL 以 确保 使 用 者 可 利用 图 13.10 中 的 代码 生成 的 API 25937 [n] 
当前 API。 对 此 ， 需 要 传递 一 个 包含 当前 key 的 apikey k, Al hr: 

curl -i -X GET --url http://192.168.99.100:8000/ --header 'Host: 

dineshonjava.com' --header 'apikey: yyBFOR5LDfaAbAksT9Iqf£HWwLOpVYbtGc' 

图 13.21 中 使 用 了 apikey 访问 安全 的 API. 

当前 ， 使 用 者 可 通过 API 密 钥 并 作为 一 个 授权 号 份 验证 密 钥 访问 党 限 的 API。 可 以 
看 到 ，KONG 对 于 API 官 理 来 说 是 一 个 较 好 的 框 染 ， 退 过 将 相关 服务 置 于 KONG 后 方 ， 
并 通过 KONG 插件 添加 功能 项 ， 它 向 REST API 提供 了 大 量 的 可 扩展 功能 ， 且 全 部 操作 
均 位 于 一 条 命令 中 ， 如 图 13.22 所 示 。 
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curl -i -A GET N 
—-url http:7719ł92.168.99.100: 800607 ` 
——header "Host: ANS non jaui. com’ N 


Content-Type: application/jsonscharset-lUTF-8 


Iransfer-Encoding: chunke 

Connection: keep-alive 

^h—HateLimit-Limit-minute: 188 
—RHateLimit-Hemainingy-minute 

Date: Fri. 20 fpr 2818 ii: 27: 23 "eM 

u—Kong-Upstream- Latency: 18 

n-Kong-Proxy-Latencyuy: 155 

Uia: kongy^/B.13.H 


[4"' accountid" - 188, "balance":35B82.92, "customerld" 


vi, “accounti ype” "SAU ING” ,branchCode" "ICICIBEI" 


"bank" "HDFC''?, C 'account Id" :-2ZU1, "halance" 


43. "customerId" 1082. "accountType":' 'SAUING". 


Code": "ICICIBB3", "bank": ICICI*»] 


图 13.21 


LOGGING 


图 13.22 


其 中 , KONG 置 于 底部 , 进而 可 向 REST API 提供 API 
API 中 一 些 较为 重要 的 特性 。 
KONG API 包含 以 下 特性 。 


1888, 
bank 
: 3122. 85, "' 'rusto 


"hbranchCGode"'': 


管理 功能 


, 接 下 来 讨论 KONG 


口 “ 可 扩展 性 : 我 们 可 方便 地 提升 KONG API 的 扩展 性 ， 即 横向 增加 机 器 的 数量 。 
可 扩展 性 的 一 个 优点 体现 在 ;可 处 理 任 何 负载 ， 同 时 保持 系统 的 低 延 迟 。 

Q Hk: KONG 可 将 API 划分 为 不 同 的 部 分 ， 进 而 可 方便 地 处 理工 作 负 载 。 通 
过 向 API 添加 额外 的 插件 ， 即 可 实现 KONG API 的 模块 化 处 理 。 当 以 管理 员 身 
份 操控 RESTful API 源 代码 时 ， 可 轻松 地 对 这 些 插件 进行 配置 。 

Q ”可 运行 于 任何 基础 设施 上 : KONG 的 部 署 工 作 不 会 受到 任何 基础 设施 的 限制 。 
无 论 是 云 计 算 还 是 本 地 应 用 ，KONG 部 可 以 按照 指令 运行 。 同 时 ， 数 据 中 心 还 
可 针对 所 有 类 型 的 API 提供 单项 或 多 项 设置 《包括 公有 、 私 有 和 仅 党 邀请 的 


APT) x 
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2c P imi k KONG 提供 的 工作 流 。KONG 服务 器 提供 请 求 的 API 并 作为 API 的 平台 。 
在 设置 完毕 后 ， 全 部 API 请 求 首 先 访 问 KONG 服务 器 ， 随 后 将 其 转发 至 最 终 的 API。 在 
请 求 - 啊 应 时 间 内 ，KONG 将 执行 一 个 癌 用 户 提 示 下 载 的 插件 ， 安 装 后 的 插件 将 进一步 增 
强 API 的 能 力 。 通 过 这 种 方式 ，KONG 服务 器 将 成 为 API 请 求 的 主要 入 口 点 。 

KONG 可 更 加 方便 、 快 速 地 对 API 进行 微 管 理 。 科 技 公 司 、 电 子 商 务 创 新 者 、 大 型 
银行 公司 ,甚至 许多 政府 机 构 都 趋向 于 将 KONG 作为 Web 工作 负载 的 主 服务 器 。 这 也 提 
升 了 KONG 平台 在 全 球 开 发 人 员 中 的 受 欢迎 程度 , 也 激励 着 他 们 为 KONG 平台 的 创新 做 
出 更 大 的 贡献 。KONG 专注 于 客户 的 满意 度 和 技术 上 的 不 断 进 步 ， 同 时 打造 了 一 个 名 副 
其 实 的 国际 平台 。KONG 不 仅 开 发 API， 还 帮助 客户 意识 到 微服 务 基 础 设施 对 于 安全 性 、 
敏捷 性 和 可 伸缩 性 的 重要 性 。 

接 下 来 将 讨论 如 何在 Spring Boot 微服 务 项 目 中 创建 REST API 文档 。 


13.4 Swagger 


Swagger 是 一 个 开源 平台 ， 并 为 开发 人 员 提 供 了 各 种 工具 ， 进 而 设计 、 构 建 、 文 档 化 
和 使 用 RESTful Web 服务 。 虽 然 Swagger 因 其 用 户 接 口 工 具 为 人 们 所 知 ， 但 也 为 用 户 提 
供 了 其 他 工具 ， 例 如 目 动 化 和 测试 用 例 。 

起 初 ，Swagger API 的 流行 度 仅 限 于 小 规模 的 机 构 和 独立 开发 人 员 。 大 多 数 时 候 ， 
RESTful API 并 不 支持 机 器 可 读 性 机 制 ， 但 Swagger API 提供 了 一 种 简单 易 行 的 方法 。 
IRR, Œ Apache 2.0 开源 许可 的 帮助 下 ， 产 品 和 在 线 服 务 将 Swagger 作为 其 工具 包 的 
一 部 分 内 容 。 不 入，Apigee、Intuit、 微 软 和 IBM 等 路 国 公司 也 开始 公开 文 持 Swagger 
项 目 。 

接 下 来 将 讨论 REST API 中 Swagger 的 应 用 方式 。 


13.4.1 Swagger 应 用 


Swagger API TEHER OR J UA FR — EET R EBIINZ FH e 

Q JH% API: Swagger 的 API HELEH EJERS Open API X 
Fi. JEIESXH WAE AEN” k "B hf E" HJ API 开 友 。 当 采用 Swagger 
API 提供 的 男 一 个 工具 时 ， 即 Swagger Codegen， 编 程 人 员 可 解 业 Open API X: 
Ri. n] DEBE B AE pee P RU BR AS Y FN e 

OD “与 API 的 交互 : Swagger Codegen (E4324 1m H/M n] Jk Open API Doc 中 生成 SDK 
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代码 ， 从 而 减少 了 对 人 工 生成 的 客户 机 代码 的 需求 。 针 对 SDK Client 所 生成 的 
Afi, Swagger Codegen 项 目 当 前 支持 超过 50 种 格式 和 语言 。 

D ”文档 机 制 : 3 Open API 文档 来 说 , 该 API 是 一 类 开源 工具 箱 , 并 可 通过 Swagger 
UI 和 耳 接 与 该 API HITEH. AIM AW HAAN F HTML Hz EX P? A 
面 直 接连 接 到 API. 

针对 Account 微服 务 ， 接 下 来 考查 基于 REST API 的 Swagger 实现 。 


13.4.2 在 做 服 务 中 使 用 Swagger 


本 节 将 讨论 针对 Account 微服 务 的 REST API 构建 示例 , 任何 REST API 都 需要 包含 
较 好 的 文档 应 用 机 制 。 

管理 和 创建 文档 是 一 项 较为 枯 爆 的 工作 ， 因 此 ， 我 们 应 使 这 一 过 程 自 动 化 。 相 应 地 ， 
API 中 的 每 个 更 改 都 应 该 在 参考 文档 中 同时 进行 描述 。 针 对 于 此 , Swagger 可 对 REST API 
的 文档 实现 自动 化 处 理 。 

针对 Spring Web 服务 ,本 节 将 考查 Swagger 2 的 应 用 示例 ,相关 示例 将 使 用 到 Swagger 
2 的 SpringFox。 

另外 ， 我 们 还 将 再 次 考 得 之 前 的 Account 微服 务 示 例 。 因 此 ， 首 先 需 要 在 Account 
微服 务 示 例 的 pom.xml 文件 中 添加 针对 Swagger 2 的 SpringFox 实现 的 Maven 依赖 关系 。 

1. 添加 Maven 依赖 关系 

在 Account 微服 务 项 目 中 ， 人 针对 Swagger 2 规范 的 SpringFox IN, man Maven 
依赖 天 系 ， 如 下 所 示 : 


<dependency> 
<groupId>io.springfox</groupId> 
<artifactId>springfox-swagger2</artifactId> 
<version>$ {swagger.version}</version> 
</dependency> 
在 上 述 Maven 依赖 项 中 , 我 们 利用 io.springfox 和 springfox-swagger2 针对 Swagger 2 
WS I SpringFox 依赖 关系 。 接 下 来 通过 下 列 配置 项 配置 Swagger- 


«properties» 


«swagger.version»2.7.0«/swagger.version» 


«/properties» 


在 同 Account 微服 务 示例 中 加 入 了 Swagger 2 依赖 关系 后 ， 下 和 面 将 整合 Swagger2 W 
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WIRA o 
2. 在 项 目 中 配置 Swagger 2 
这 里 将 采用 基于 Java 的 配置 项 在 Account 微服 务 项 目 中 配置 Swagger 2， 如 下 所 示 : 


package com.dineshonjava.accountservice.config; 


import org.springframework.context.annotation.Bean; 


import org.springframework.context.annotation.Configuration; 


import springfox.documentation.builders.PathSelectors; 

import springfox.documentation.builders.RequestHandlerSelectors; 
import springfox.documentation.spi.DocumentationType; 

import springfox.documentation.spring.web.plugins.Docket; 


import springfox.documentation.swagger2.annotations.EnableSwagger2; 


aConfiguration 
aEnableSwagger2 
public class SwaggerConfig 1 
aBean 
public Docket apitt) i 
return new Docket (DocumentationType.SWAGGER 2) 
-Select () 
.apis (RequestHandlerSelectors.any()) 
.paths (PathSelectors.any()) 
.buildt); 


} 


其 中 ， BOBESZ BUSH f QConfiguration M@EnableSwagger2 Ef, KE, BREAK 
主要 涉及 Docker Bean。 有 具体 来 说 ，@Configuration 注解 使 得 该 类 定义 为 项 目的 配置 类 ; 
tent ^^ H Hia Hl Swagger 2 功能 。 

上 述 配置 定义 了 一 个 Bean Docket。 通 过 这 一 Bean 定义 ， 将 生成 DocumentationType. 
SWAGGER 2 的 Bean. 。 在 配置 代码 中 可 以 看 到 ，select0 方 法 将 返回 一 个 
ApiSelectorBuilder 实例 。ApiSelectorBuilder 提供 了 一 种 方式 可 控制 Swagger AITH i E o 
男 一 个 方法 paths0 将 返回 一 个 谓词 实例 ， 并 提供 了 一 种 方式 选择 RequestHandlers。 相 应 
地 ，RequestHandlers 可 通过 RequestHandlerSelectors 和 PathSelectors 进行 配置 。 

最 后 , PathSelectors 的 any0 方 法 针对 Swagger 得 到 的 全 部 API 准备 文档 。 针 对 Account 
做 服务 ， 该 文档 对 于 将 Swagger 2 整合 至 现 有 的 Spring Boot 项 目 来 说 已 然 足够 。 接 下 来 

运行 该 项 目 并 验证 SpringFox 十 含 可 正 弟 工作 。 
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在 浏览 器 中 访问 http://localhost:6060/v2/api-docs, 该 将 以 REST API X FAR JSON 
数据 格式 显示 结果 ， 如 图 13.23 Br. 


g localhost6060/v2/api-d- x A — 1 


= G localhost:6060/v2/api-docs 
|: 


m 


swagger: "2.0", 

- info: 1 
description: "Api Documentation", 
version: "1.0", 
title: "Api Documentation", 
termsOfService: "urn:tos", 
contact: | 上 ， 

- license: | 
name: "Apache 2.0", 
Wh z:/licenses/LICENSE-2. 


host: "localhost:6060", 
- itags: [ 


"t 


name: "account-controller", 
description: "Account Controller" 


p fs, adl 


name: "basic-error-controller", 
description: "Basic Error Controller" 


- paths: ( 
- /account: { 
- get: { 
- tags: [ 


'account-controller" 


]; i 


summary: "all", 


图 13.23 


作为 JSON 啊 应 结果 ， 其 中 包含 了 大 量 的 键 - 值 对 〈 图 13.23 中 仅 显 示 了 部 分 结果 ) ， 
但 该 啊 应 结果 并 不 具备 人 类 可 读 的 格式 。 另 外 ， 在 Account 微服 务 Spring Boot 项 目 中 ， 
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通过 添加 另 一 个 Maven 依赖 项 ，Swagger 还 针对 REST API 文档 提供 了 Swagger UI, F 
面 将 对 此 加 以 分 析 。 

3. 在 项 目 中 配置 Swagger 

通过 Swagger 2 库 中 的 内 建 方案 , 可 在 微服 务 项 目 中 轻松 地 配置 Swagger UI, 它 使 用 
Swagger 生成 的 API 文档 创建 Swagger UI。 下 列 代 人 码 针 对 Swagger UI 配置 了 男 一 个 Maven 
WIRA o 


<dependency> 
«groupId»io.springfox«/groupId» 
«artifactlId»springfox-swagger-uic«/artifactlId» 
«version»$[swagger.version]«/version» 
</dependency> 
此 处 利用 包含 既定 版 本 的 io.springfix 和 springfox-swagger-ui 添加 了 一 个 依赖 关系 ， 
这 对 于 在 项 目 中 配置 Swagger UI 进而 查看 API 文档 来 说 已 然 足够 。 全 部 所 需 的 HTML 页 
面 仅 通过 该 库 进 行 显示 ， 且 无 须 针 对 这 一 Swagger UI 设置 任何 HTML. 
下 面 再 次 运行 Spring Boot Account 微服 务 ， 并 在 浏览 器 中 访问 http://localhost:6060/ 
swWaggefr-uUi.html#/ 对 其 进行 出 试 。 
图 13.24 显示 了 对 应 的 Swagger UI. 


(D Swagger UI xE y 
€ G | © localhost6060/swagger-ui.html/ Oa Z -:mBa 


t} swagger | default (/v2/api-docs) v Explore 


Api Documentation 


^pi Documentation 
Apache 2.0 
account-controller : Account Controller Show/Hide | List Operations | Expand Operations 


basic-error-controller : Basic Error Controller Show/Hide | List Operations | Expand Operations 


| BASE URL: / , API VERSION: 1.0 | 


13.24 
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这 将 显示 Spring Boot 项 目 中 Account 微服 务 的 Swagger UI， 即 一 个 控制 器 列表 ， 其 
原因 在 于 ，Swagger 扫描 项 目 代 码 ， 并 对 所 有 控制 器 公开 文档 。 客 户 问 可 使 用 该 URL 和 
Swagger UI 学 习 如 何 使 用 REST API。 它 显示 了 针对 每 个 URL 调用 的 所 有 HTTP 方法 ; 
此 外 还 显示 了 要 发 送 的 输入 文档 和 预期 的 状态 代码 。 

在 上 述 Swagger UI 示意 图 中 , 可 单 击 显示 列表 中 的 任意 控制 器 , 这 将 显示 一 个 HTTP 
方法 列表 , WI DELETE. GET. HEAD. OPTIONS. PATCH. POST 和 PUT. 单 击 Swagger 
UI 中 的 任意 方法 还 将 显示 额外 的 细节 信息 ， 如 内 容 类 型 、 啊 应 状态 和 参数 。 另 外 ， 还 可 
单 击 Swagger UI 中 的 Try it Out! 按 钮 对 该 方法 进行 测试 。 

在 图 13.25 中 ， 当 单 击 Swagger UI 中 的 账户 控制 器 链接 时 ， 将 展开 账户 控制 器 中 的 
现 有 方法 , 图 13.25 中 显示 了 基于 HTTP DELETE 的 delete0 方 法 、 基 于 HTTP GET 的 all0 
方法 、 基 于 HTTP POST 的 save0 方 法 以 及 基于 HTTP PUT 的 update0 方 法 。 


Dinesh 


(D Swagger UI 


,和 C | () localhost:6060/swagger-ui.htmls/ 


{} swagger default (/v2/api-docs) v Explore 


Api Documentation 


Api Documentation 
Apache 2.0 


account-controller : Account Controller Show/Hide | List Operations | Expand Operations 


DELETE account delete 


account all 


POST /account save 


/account update 


13.25 


在 图 13.25 中 ， 单 击 deleteO. all. saveO ll updateO 中 的 任意 一 个 方法 ，Swagger UI 
将 显示 如 图 13.26 所 示 的 UI. 

这 将 显示 诸如 Response Status. Input Parameters. Response Content Type 和 HTTP 
Status Code 等 详细 信息 。 另 外 ， 还 可 单 击 Try it out! 按 钮 测试 该 API 方法 。 
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Dinesh 
| (D Swagger UI 


= © localhost:6060/swagger-ui.html#!/account45controller.. yr | © œœ D E 
-i + 


*** Apps Training | Pivotal C) Does Spring Certifics Q Oracle Certified Java 4 Plagiarism Checker a 
account-controller : Account Controller Show/Hide | List Operations 


P 


Expand Operations 


DELETE /account delete 


account all 


Response Class (Status 200) 
OK 


Example Value 


Response Content Type | */* Y | 
Response Messages 


idm status Reason Response Model Headers 


401 Unauthorized 
Forbidden 


404 Not Found 


| Try it outi | 


save 


update 
图 13.26 


REH, dETIDON—^ sa CEU AccountController) 创建 了 API 文档 。 如 果 在 
同一 应 用 程序 中 加 入 另 一 个 控制 右 CustomerController，Swagger 则 可 方便 地 与 代码 库 同 
步 。 考 查 下 列 控制 器 : 


@RestController 

public class CustomerController | 
QGetMapping ("/customer/name") 
public String customerName () { 

return "Arnav Ba]put": 

} 
@PostMapping ("/customer/name") 
public String addCustomerName () { 


return "Aashi Rajput"; 
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在 添加 了 控制 器 并 利用 Swagger UI 刷 新 了 浏览 器 后 , 将 显示 一 个 包含 CustomerController 
的 控制 右 列 表 ， 如 图 13.27 所 示 。 


aCccoLIr it «(^ (0) 


Show/Hide | List Operations Expand Operations 


customerName 


i/customer/name ustomerName 


图 13.27 


其 中 可 看 到 Swagger 捉 供 的 默认 元 配置 ; 此 外 ,还 可 利用 Docket Bean 并 根据 应 用 程 
序 参 数 对 这 一 元 配置 项 进行 配置 。 接 下 来 讨论 如 何 利 用 Swagger 在 Spring Boot 应 用 程序 
中 加 入 额外 的 配置 内 容 。 

4. 自 定义 Swagger UI 元 配置 

我 们 可 以 在 应 用 程序 中 自 定义 Docket Bean 配置 内 容 ， 并 针对 REST API 文档 生成 赋 
予 更 多 的 控制 权 。 下 和 面 考查 如 何 针对 Swagger mMMR API. 

下 列 代 码 展 示 了 更 新 后 的 Docket Bean 配置 : 

Bean 

public Docket api() 1{ 

return new Docket (DocumentationType.SWAGGER 2) 
-Select () 
.apis (RequestHandlerSelectors.basePackage ("com.dineshonjava.accountservice. 
controller")) .paths(PathSelectors.ant ("/customer/*")) 
.bulldi)jz 

} 

在 上 述 Docket Bean 配置 中 ， 我 们 根据 当前 文 梢 过 滤 f 4b APL AHR, RAITH 
PRAHE API 的 文档 内 容 。 人 针对 于 此 ， 可 同 Docket 类 的 apisO0 和 pathsO 方 法 中 传递 
相关 参数 ， 并 以 此 限制 Swagger 的 啊 应 结果 。 上 具体 来 说 ，RequestHandlerSelectors 可 使 用 
any 或 none 谓词 。 此 外 ， 还 可 使 用 RequestHandlerSelectors 并 根据 基础 包 (com.dineshonjava. 
accountservice.controller) 、 类 注解 和 方法 注解 过 滤 API. 

Swagger 还 可 通过 谓词 进行 过 滤 。 相应 地 , pathsO 〇 方法 使 用 PathSelectors 类 作为 参数 ， 
并 提供 了 额外 的 过 滤 机 制 。 其 中 ，PathSelectors 类 定义 了 多 种 方法 可 扫描 应 用 程序 的 请 求 
路 径 ， 如 anyO、noneO、fresgex0 或 ant0 方 法 。 

在 当前 示例 中 ，Swagger 将 仅 包含 一 个 具有 特定 路 径 的 com.dineshonjava.accountservice. 
controller 包 ， 访 路 径 使 用 antO 谓 词 在 URL 中 包含 /customer/*。 刷新 Swagger UI EXI v, 
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后 ， 对 应 结果 如 图 13.28 所 示 。 


default (/v2/api-docs) v 


Api Documentation 


pi Documentation 


Show/Hide | List Operations | Expand Operations 
Icustomer/name customerName 


i/customer/name 


图 13.28 


Swagger (XX 8115 /customer/* URL 模式 的 REST API 创建 文档 。 在 图 13.28 中 ， 还 可 
看 到 其 他 信息 ， 例 如 API 版 本 、API Documentation 以 及 Created by Contact Email. 另外， 
用 户 还 可 在 应 用 程序 中 修改 此 类 API 信息 。 

下 和 面 明 过 一 些 示 例 添 加 自 定义 API 信息 。 对 此 ， 可 采用 apilnfo(ApiInfo apiInfo)7; 
法 修改 API 信息 ， 例 如 API 版 本 、API Documentation 或 Created by Contact Email， 如 下 
所 示 : 


aBean 
public Docket apií) [| 
return new Docket (DocumentationType.SWAGGER 2) 

.select() 
-apis (RequestHandlerSelectors.basePackage ("com.dineshonjava.accountservice. 
controlter")) 

-paths(PabhSelectors.ant("/cusboumer/*")) 

.buxzldt) 

-apitinfolapitnfot)); 
} 
private ApiInfo apilInfo() { 

return new ApiInfo( 

"Customer Microservice REST API", 

"These gre customer service APIS." 

“APT 2:05; 

"https://www.dineshonjava.com/Termsofservice", 

new Contact("Dinesh Rajput", "https://www.dineshonjava.com", 
"admin(üdineshonjava.com"), 

"License of API", "https://www.dineshonjava.com/license", Collections. 
emptyList()); 
} 
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在 上 述 配置 中 ,Docket Bean 通过 apiinfo0 方 法 进行 配置 ; apiinfo0O 方 法 则 提供 了 包含 


相关 信息 的 API， 例 如 API 文档 名 、API 版 本 、APTI 描述 、 联 系 方式 和 服务 条 蒜 URL. 
刷新 浏览 器 中 的 Swagger UI 后 ， 对 应 结果 如 图 13.29 所 示 。 


© default (/v2/api-docs) Y 


Customer Microservice REST API 


These are customer service APIS. 


Created by Dinesh Rajput 
See more at https //www. dineshonjava.com 


Contact the developer 


"E a XE ADO 


customer-controller : Customer Controller Show/Hide ^ List Operations | Expand Operations 


icustomer/name customerName 


/customer/name addCustomerName 


图 13.29 


HEP Swagger UI 显示 了 API 信息， 例如 API 版 本 、API 文档 和 电子 邮件 联系 方式 
对 于 啊 应 方法 的 目 定 义 消 息 ， 考 否 下 列 更 新 后 的 Docket Bean 配置 : 


aBean 
public Docket api() 1{ 
return new Docket (DocumentationType.SWAGGER 2) 
-Select () 
.apis (RequestHandlerSelectors.basePackage ("com.dineshonjava.accountservice. 
controller") 
.paths (PathSelectors.ant("/customer/*")) 
bu bdt) 
-apiInfo (apiInfo()) 
.useDefaultResponseMessages (false) 
-globalResponseMessage (RequestMethod.GET, 
newArrayList( 
new ResponseMessageBuilder () 
code (3001) 
.message("500 : Internal Server Error into 
customer microservice") 


.responseModel (new ModelRef ("Error")) 
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-build({}, 

new ResponseMessageBuilder () 
-Code (403) 
-message ("API Request Forbidden!") 
.buildtf, 

new ResponseMessageBuilder () 
-Code (404) 
.messaogeiBequest. API Wot Found!) 
build fl) 
)); 

} 


在 上 述 Docket Bean 配置 中 , ARIN NZ YE I Ux EL 7J false, 并 指示 Swagger 不 要 使 
用 默认 的 啊 应 消息 ; 此外， 还 通过 Docket 的 globalResponseMessage07; AE, [. HTTP 
的 全 局 啊 应 消息 。 在 当前 示例 中 ， 针 对 Customer 微服 务 的 所 有 方法 ， 分 别 利用 500/403 
和 404 代码 重 载 了 3 个 啊 应 消息 。 

13.30 28 flr] v, ds Jr HP] Is ZI Ei e 


customer-controller : Customer Controller Show/Hide | List Operations | Expand Operations 


icustomer/name customerName 
Response Class (Status 200) 
string 
Response Content Type | "/* v 


Parameters 


Parameter Value Description Parameter D 


Type ata Type 


name name query string 


Response Messages 
ix status Reason Response Model He 
403 API Request Forbidden! 
404 Request API Not Found! 


560 500 : Internal Server Error into 
customer microservice 


Try it out! 


图 13.30 


此 处 重 载 了 HTTP 状态 码 的 默认 啊 应 消息 ， 如 403. 404 和 500. [X f Dpcket Bean 
配置 之 外 ，Swagger 还 可 使 用 Swagger 注解 日 定义 API 文档 。 
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5. 利用 Swagger 注解 进行 自 定义 

Swagger 在 现 有 Spring MVC 注解 的 基础 上 加 入 了 一 些 额 外 的 注解 。 

在 做 服务 应 用 程序 中 ， 文 持 文 档 化 的 每 个 REST 控制 右 须 通过 @Api 进行 和 注解， 如 下 
HIZR: 

QGApi( value - "/customer", description - "Manage Customer" ) 


public class CustomerController | 


P s 
) 


其 中 ，CustomerController 类 通过 包含 value 和 description 属性 的 @Api 加 以 注解 。 
(Q) Api VERE BL f E5558 d HA DAHR HITI e 

随后 ,REST Controller 类 的 每 个 请 求 处 理 方法 应 采用 @ApiOperation 进行 注解 。 该 注 
解体 现 了 静态 方法 的 职责 。 此 外 ， 还 可 使 用 包含 请 求 处 理 方 法 的 另 一 个 Swagger 注解 ， 
即 @ApiResponses/@APpiResponse， 如 下 所 示 : 

@GApiOperation (value = "Returns Customer Name") 

aApiResponses( 

value ~ í( 
aApiResponse(code = 100, message - "100 is the message"), 
aApiResponse(code = 200, message = "Successful Return Customer Name") 
} 

) 

@GetMapping ("/name") 

public String customerName (@ApiParam (name="name", value-"Customer Name") 

String name) { 

return "Arnav Rajput"; 

} 

HEH, CustomerController 的 请 求 处 理 方法 采用 @ApiOperation 和 @ApiResponse/ 
@ApiResponses 加 以 注解 。 

如 果 请 求 处 理 方法 接收 参数 ， 对 应 参数 应 采用 @ApiParam 注解 。 在 上 述 示例 中 可 以 
看 到 ，(@ApiOperation 注解 体现 了 特定 方法 的 职 贡 。 

类 似 地 ， 还 可 对 模型 类 进行 文档 化 以 提供 模型 的 模式 ， 这 将 有 助 于 通过 特定 注解 的 
请 求 - 啊 应 结构 的 文档 化 处 理 ， 例 如 采用 @ApiModel 注解 。REST 资源 类 或 模型 也 需要 特 
定 的 注解 ， 例 如 @ApiModel 和 @ApiModelProperty。 考 但 下 列 Customer 模型 类 : 

aApiModel( value - "Customer", description = "Customer resource 


representation" ) 


public class Customer 1{ 
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aApiModelProperty (notes "Name of the Customer") String name; 
aApiModelProperty(notes = "Email of the Customer") String email; 
aGApiModelProperty(notes = "Mobile of the Customer") String mobile; 


aApiModelProperty (notes = "Address of the Customer") String address; //... 


} 
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Model 


Customer 1 
address (string, optional): Address of the Customer, 
email (string. optional). Email of the Customer, 
mobile (string, optional): Mobile of the Customer, 
name (string, optional): Name of the Customer 


} 


Response Content Type | *P v 


Parameter 


Parameter Value Description Type Data Type 


customer |{ customer body Model 
E D DEF RS Customer ( 
email": "string' | 
"mobile": "string" ; address (string, optional): Address of the 
"name": "string" Customer, 
} E email (string, optional). Email of the 
Customer, 


Parameter content type: | application/json Y mobile (string, optional). Mobile of the 
Customer, 
name (string, optional). Name of the 
Customer 


| Try it out! 
图 13.31 


图 13.31 显示 了 与 Customer 类 的 模型 相关 的 详细 信息 。 目 前 ，Swasgsger 提供 了 更 具 
摘 述 性 的 API 文档 ， 因 此 可 利用 Swagger 注解 方便 地 目 定 义 API 文档 。 

2e FORI API 文档 系统 的 创建 速度 与 服务 器 相同 。Swagger 使 用 服务 器 代码 中 描述 
的 方法 、 参 数 和 模型 维护 API 及 其 文档 中 的 同步 机 制 。 


13.4.8 Swagger 的 优点 


Swagger Framework Wi UA FD ki: 
D AHIRI di RUE ii AA [89388 8 [8] 27 API 文档 。 
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D 可 生成 REST API 文档 并 与 REST PI 进行 交互 。 基 于 Swagger UI Framework 的 
REST API 交互 对 于 API 与 参数 间 的 啊 应 方式 生成 了 更 加 清晰 的 结果 。 

Q ”以 JSON fll XML 格式 提供 啊 应 结果 。 

D ”实现 过 程 文 持 多 种 技术 ， 如 Scala, Java 和 HTMLS. 

上 述 内 容 讨 论 Spring Boot 微服 务 项 目 中 Swagger Framework 的 实现 ， 并 公开 了 
Account 和 Customer REST API。 在 该 示例 中 ， 我们 针对 Account 和 Customer REST API 创建 
了 REST API 文档 。 读 者 可 访问 GitHub 获取 完整 的 示例 代码， 对 应 网 址 为 https://github.comy 
PacktPublishing/Mastering-Spring-Boot-2.0. 
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本 章 讨 论 了 如 何 管理 API。API 管理 涉及 速率 限制 、 验 证 授权 和 日 志 机 制 。 其 中 ， 速 
紊 限制 是 一 类 简单 的 算法 ， 用 于 根据 业务 需求 限制 API 的 使 用 ， 无 论 是 为 了 人 盘 利 还 是 为 
T RS DOS 攻击 。 

男 外 ， 本 草 还 讲述 了 如 何 利 用 Docker 运行 KONG， 其 间 我 们 创建 了 一 个 用 例 ， 并 通 
it KONG 管理 API 进行 管理 。KONG 插件 针对 API 提供 了 较 大 的 灵活 性 和 自 定 义 机 制 。 

最 后 ， 我 们 还 学 习 了 Swagger 2 并 针对 Spring REST API 实现 了 文档 化 操作 。 男 外 ， 
本 章 还 介绍 了 Swagger UI Framework, Jf] Swagger 的 输出 结果 了 予以 可 视 化 和 目 定 义 。 

第 14 章 将 讨论 如 何 将 微服 务 部 车 至 AWS 云 中 。 
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本 章 将 探讨 在 AWS EC2 实例 中 手动 部 普 微 服务 并 使 用 CloudFormation 脚本 。 其 中 ， 
读者 将 了 解 如 何在 亚马逊 弹性 计算 云 (EC2 ) 实例 上 运行 支持 Docker 的 Spring Boot 微服 
务 应 用 程序 。 

上 述 章 贡 讨论 了 微服 务 架 构 的 不 同方 面 及 其 优点 ， 例 如 可 扩展 性 、 容 错 机 制 等 。 尽 
党 如 此 ， 微 服务 架构 仍 面 临 痢 诸多 挑战 ， 例 如 微服 务 部 著 管 理 和 分 布 式 应 用 程序 的 基础 
设施 依赖 关系 。 相 应 地 ， 容 器 化 即 是 针对 此 类 问题 的 一 种 解决 方案 。Docker 提供 了 一 类 
容器 化 方案 ， 并 在 缺少 基础 设施 依赖 关系 的 基础 上 开发 和 部 署 微 服务 ， 参 见 第 12 章 。 气 
此 ， 我 们 可 方便 地 将 Docker 容器 部 署 至 亚马逊 Web 服务 CAWS) ~ Azure, Pivotal Cloud 
Foundry 等 。 

本 章 主要 涉及 以 下 内 容 : 

D AWS EC2 实例 。 

AWS 上 的 微服 务 染 构 。 
将 微服 务 上 友 布 至 Docker Hub. 
在 AWS EC2 上 安装 Docker。 

Q 在 AWS EC2 上 运行 微服 务 。 

在 阅读 完 本 章 后， 读者 将 能 够 较 好 地 理解 如 何 采 用 手动 方式 将 微服 务 和 Docker 容器 
WI S AWS EC2 实例 中 ， 以 及 如 何 使 用 CleudFormation 脚本 。 


LLL 


14.1 AWS EC2 实例 


JE. Web 服务 (AWS) 针对 云 计 算 解 决 方案 提供 了 多 种 平台 ， 我 们 可 使 用 AWS 
构建 和 发 布 应 用 程序 。 亚 马 逊 EC2 是 一 项 在 云 中 提供 可 调整 计算 能 力 的 服务 ， 使 开发 人 
员 更 容易 进行 Web 规模 的 云 计 算 。 

男 一 个 平台 则 是 AWS 弹性 容器 服务 ， 并 可 利用 Docker 部 署 微 服务 。 通 过 创建 应 用 
程序 的 Docker 镜像 ， 微 服务 可 部 署 至 亚马逊 ECS 中 。 用 户 可 方便 地 将 该 Docker 镜像 置 
入 亚马逊 弹性 容器 存储 库 (ECR) . 

在 本 章 中 , 将 使 用 应 用 程序 的 Docker 镜像 将 一 个 微服 务 部 署 至 亚马逊 EC2 中 。 其 间 
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将 使 用 Docker Hub 这 一 Docker 存储 库 以 推送 Docker 镜像 。 
下 面 考 得 如 何 设置 一 个 亚马逊 EC2 实例 ， 相 关 步 又 如 下 : 
(1) 首先 需要 设置 一 个 亚马逊 账户 。 针 对 于 此 ， 读 者 可 访问 https://aws.amazon.com/ 
free/ 并 创建 一 个 免费 账户 ， 如 图 14.1 所 示 。 


AWS 


Root user sign in © 


Email: gmail.com 


Password Forgot password? 


Sign in to a different account 


Create a new AWS account 


图 14.1 
(2) 登录 AWSManagement Console。 登 录 成 功 后 ， 对 应 画面 如 图 14.2 所 示 。 


AWS services 


v Recently visited services 


— — € 


run | T -————— [^ je A Bom mm 
EC2 | Elastic Container Service Cost Explorer 


图 | CloudFormation Is] Billing 


> All services 
E142 


图 142 显示 了 所 有 的 AWS 服务 ， 单 击 并 对 其 进行 适当 配置 后 ， 用 户 可 使 用 每 项 服务 。 
(3) "Ri NE HX AWS 仪表 盘 上 的 EC2 服务 后 ， 对 应 结果 如 图 14.3 所 示 。 


Services ~ Resource Groups ~ * 


| EC2 Dashboard a Resources Œ Account N- 
| Events Attributes C 
You are using the following Amazon EC2 resources in the US 

a East (Ohio) region: supported Platforms 


Heports 
f Ü Running Instances 上 Iastic IPs VPC 


~ 


0 Dedicated Hosts snapshots Default VPC 


INSTANCES 0 Volumes Load Balancers vpc-f04a2398 
Instances 


0 Key Pairs security Groups 
-" m y pw p Resource ID length 
Launch Templates -— E : 

spot Requests 


Reserved Instances Create Instance Additional 

Dedicated Hosts | Information 

To start using Amazon EC2 you will want to launch a virtual 

server, known as an Amazon EC2 instance. Getting Started 
| Guide 


AMIS | | 
Launch Instance w MN 
Bundle Tasks | Documentation 


TE à T All EC2 Resources 
ELASTIC BLOCI Note: Your instances will launch in the US East (Ohio) region 


STORE Forums 
Volumes . . Service Health C Scheduled Events C" pricing 


图 14.3 


在 图 14.3 中 ，EC2 Dashboard 显示 了 EC2 实例 的 全 部 有 效 选项 
(4) 当 创 建 一 个 EC2 实例 时 ， 可 单 击 Launch Instance 按钮 ， 这 将 显示 相关 选项 ， 
随后 可 选择 Amazon Machine Image (AMD， 对 应 结果 如 图 14.4 所 示 。 


1 to 35 of 35 AMIS 


Amazon Linux AMI 2018.03.0 (HVM), SSD Volume Type - ami-97615212 


Amazon Linux The Amazon Linux AMI is an EBS-backed, AWS-supported image. The default image includes 
AWS command line tools, Python, Ruby, Perl, and Java. The repositories include Docker, PHP. 
MySQL, PostgreSQL, and other packages. 


Root device type: ebs Virtualization type: hwm 


Amazon Linux 2 LTS Candidate 2 AMI (HVM), SSD Volume Type - ami-31c7f654 


Amazon Linux Amazon Linux 2 LTS Candidate 2 provides an updated version of the Linux Kernel (4.14) tuned 
for EC2, systemd support, a newer compiler (gcc /.3), an updated C runtime (glibc 2.26), newer 
tooling (binutils 2.29.1), and the latest software packages through the extras mechanisms 


64-bit 


图 14.4 


在 图 14.4 中 ， 可 根据 应 用 程序 和 业务 需求 选择 任意 AMI. AWS 包含 了 至 少 35 个 
AMI， 有 具体 选取 方案 取决 于 应 用 程序 需求 条 件 和 相关 应 用 。 另 外 ，AMI edie Es 
例如 Linux, Windows 等 。 

(5) 选择 任意 一 个 AMI。 我 们 将 在 64 位 操作 系统 中 使 用 基于 Linux HJ AMI 和 SSD 
卷 类 型 。 图 14.5 显示 了 如 何 选 择 AMI 的 实例 类 型 。 
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Currently selected: t2 micro (Variable ECUs, 1 vCPUS, 2.5 GHz, Intel Xeon Family, 1 GIB memory, EBS only) 


wn 


i vCPUs Memory Instance Storage EBS-Optimized Network 
Family Type - * " 一 a F mn - 
i (GiB) (GB) (i Available (i) Performance .i 


um 


2.nano P. EBS only Low to Moderate 


t2. micro 


EBS only - Low to Moderate 


t2 small Low to Moderate 


t2 medium Low to Moderate 


Cancel | Previous Review and Launch Next: Configure Instance Details 


图 14.5 


图 14.5 显示 了 全 部 选项 ， 我 们 可 从 中 选取 一 个 实例 类 型 。 此 处 选择 了 QO.micro. AR 
据 不 同 的 用 例 ， 亚 蕊 还 EC2 提供 了 多 种 实例 类 型 。 这 里 ， 实 例 作 为 虚拟 机 上 用 于 运行 应 
用 程序 ， 并 通过 不 同 的 组 合 方案 提供 不 同 的 功能 ， 例 如 CPU、 内 存 和 网 络 。 对 于 应 用 程 
序 来 说 ， 这 在 选取 混合 资源 时 体现 了 极 大 的 元 活 性。 

(60 AWS 还 可 配置 EC2 实例 以 满足 实际 的 需求 条 件 。 单 击 Next: Configure Instance 
Details 按钮 ， 对 应 结 末 如 几 14.6 所 示 。 


Number of instances » 1 


Launch into Auto Scaling Group ( i) 


Purchasing option (i Request Spot instances 
Network vpc-f04a2398 (default) v | C Create new VPC 


Subnet /(i No preference (default subnet in any Availability Zom v Create new subnet 


Auto-assign Public IP (i Use subnet setting (Enable) M 


图 14.6 


在 图 14.6 中 可 以 看 到 ， 可 从 同一 AMI 中 局 用 多 个 实例 ， 其 他 选项 也 将 被 包含 进来 。 
C 此 外 ,根据 应 用 程序 的 具体 需求 条 件 ， 还 可 同 实 例 中 添加 额外 的 EBS 卷 和 实例 
存储 卷 ， 如 图 14.7 所 示 。 


size 


Throuahput Delete on 
Snapshot (i (GiB) Volume Type <i) t 


(MB/s) (i Termination Encrypted |i 
» 


S 


idevixyda snap- Gi se SSD | v | 100/300 j rypt 
/dev/xvda OGbOb1641dcafe76e? General Purpose SSD (GP2) 100/3000 N/A Not Encrypted 


k 


Cancel | Previous RII EET Next Add Tags 


图 14.7 


(8) 在 绑 定 了 附加 存储 后 ， 接 下 来 癌 当 前 示例 添加 一 个 标签 ， 以 帮助 管理 示例 、 
镜像 和 其 他 亚马逊 EC2 资源 。 在 图 14.8 中 可 以 看 到 ， 此 处 添加 了 Name 键 以 及 键 值 
AccountService. 


Key (127 characters Value — (255 characters Instances Volumes 


aa bent tzlaat Elan zabeh"AdlaaflElnal 『 i E) 
MaA TINT] Maximum i | | 


Name AccountService e 


Add another tag Up to ou tags maximum) 


Cancel Previous Review and Launch Next: Configure Security Group 


图 14.8 
(9) 另外 ， 还 可 针对 当前 实例 配置 安全 组 ， 进 而 对 其 提供 保护 措施 。 该 过 程 较为 简 
A, R 14.8 中 的 Next: Configure Security Group 按钮 。 针 对 不 同 需 求 ， 此 处 存在 多 个 
安全 组 ， 例 如 控制 实例 流量 的 防火 场 规则 ， 如 图 14.9 所 示 。 


Protocol (i) Port Range /i Source |i Description /i 
TCP 22 Anywhere ™ | 0.0.0.0/0, -:/0 


Add Rule 


Cancel | Previous |l: 737-3 EC LEM 


图 14.9 


(10) 在 安全 组 配置 完毕 后 ， 单 击 Review and Launch 按钮 ， 接 下 来 将 被 询问 创建 一 
个 密 钥 对 ， 如 图 14.10 所 示 。 


Select an existing key pair or create a new key pair 


Choose an existing key pair Y 
Select a key pair 
dineshonjava Y 


+| | acknowledge that | have access to the selected private key file (dineshonjava.pem), and that 
without this file, | won't be able to log into my instance. 


Cancel Launch Instances 


图 14.10 


在 图 14.10 中 ， 我 们 生成 了 一 个 包含 名 称 dineshonjava 的 密 钥 对 ， 并 将 其 保存 至 本 地 
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人 磁盘 中 。 随 后 将 使 用 dineshonjava.pem 文件 并 通过 SSH 访问 实例 。 
还 需要 配置 一 个 密 钥 对 并 从 客户 疹 访 问 该 实例 ， 例 如 PuTTY 或 FileZilla. WR OFF 
在 密 钥 对 ， 则 可 针对 当前 实例 对 其 加 以 使 用 ;， 人 否则 需要 创建 一 个 新 的 密 钥 对 。 其 中 ， 密 
钥 对 由 存储 于 AWS 的 公 钥 和 用 户 存储 的 私 钥 构 成 。 
(11) 启用 AWS EC2 服务 的 t2.micro 实例 ， 将 显示 如 图 14.11 所 示 的 一 条 消息 。 


图 14.11 


在 图 14.11 中 可 以 看 到 ， 我 们 已 经 成 功 地 局 动 了 一 个 EC2 服务 实例 。 单 击 生成 后 的 
实例 ID， 可 对 其 进行 租 看 ， 如 图 14.12 所 示 。 


Tr Connect ^ Actions * 
o 9v O0 


q Filter by tags and attributes or search by keyword o 1to2 of2 
Name * Instance ID +| Ins 启 mcr  Availabili- Instance $~ Status Check- Alarm Ste Public DNS (=  IPv4 Public IP ~. IPvt- Key Name 


上 — AccountService i-0fbe311821f2a... t2.micro — us-east-b ^ (9 running a Initializing ^ None "3  ec2-13-59-8..  13.5988.123 - dineshonjava 


图 14.12 


上 述 内 容 讨 论 了 如 何 配置 和 启动 EC2 服务 实例 CO.micro) ， 并 将 其 命名 为 
AccountsServlce 。 
AWS EC2 实例 的 配置 和 局 动 过 程 较为 便 单 且 多 于 使 用 ， 它 包含 以 下 几 个 优点 : 
弹性 Web 级 计算 。 
完全 可 控 。 
灵活 的 云 托管 服务 。 
可 菲 性 。 
Ee 
成 本 较 低 。 
易于 启动 ， 
在 介绍 了 AWS EC2 实例 的 优点 之 后 ， 下 面 考查 AWS 上 的 微服 务 架构 。 
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14.2 AWS 上 的 微服 务 架 构 


上 述 章 节 讨 论 了 微服 务 染 构 及 其 优点 。 本 节 主 要 介绍 AWS 上 的 微服 务 架构， 以 及 如 
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何 使 用 多 项 亚马逊 服务 向 微服 务 分 布 式 应 用 程序 提供 较 好 的 原生 云 解决 方案 。 图 14.13 
显示 了 AWS 上 简单 的 微服 务 架 构 。 


FAKE 
弹性 缓存 


CloudFront | 


图 14.13 


在 图 14.13 中 ， 基 于 微服 务 的 应 用 程序 架构 设计 为 4 层 ， 即 内 容 交 付 层 、API 层 、 应 
用 程序 层 和 持久 化 层 。 

AWS 针对 应 用 程序 的 各 部 分 内 容 提 供 了 多 项 服务 ， 例 如 前 六 (用 户 界 面 )、 后 端 、 
服务 层 和 持久 化 层 。 在 应 用 程序 的 前 端 层 中 ， 服 务 将 用 于 管理 静态 内 容 〈 例 如 脚本 、 图 
像 和 CSS 等) 和 动态 内 容 , 例如 显示 Web 页 面 ; 而 诸如 亚马逊 简单 存储 服务 (Amazon S3) 
和 Amazon CloudFront 这 一 类 服务 则 用 于 服务 静态 Web 内 容 。 


O +s. 
AWS CloudFront 也 是 一 项 AWS 服务 ， 用 于 管理 网 站 内 容 和 API， 例 如 视频 内 容 和 
其 他 Web 资源 数据 。 这 是 一 个 全 局 内 容 交 付 网 络 (CDN ) ， 以 加 速 静 态 内 容 的 交付 。 


AWS 服务 (例如 Amazon S3 和 Amazon CloudFront〉 和 针对 静态 和 动态 内 容 提 供 了 多 
种 解决 方案 ， 并 用 于 加 速 内 容 的 交付 。 其 中 ，Amazon S3 服务 用 于 存储 静态 内 容 ， 例 如 
图 像 、CSS、JS 等 ，Amazon CloudFront 则 用 于 传输 这 一 类 静态 内 容 。REST API 使 用 微 
服务 为 前 端 提 供 动 态 内 容 。 为 了 减少 网 络 延 返 ， 也 可 采用 其 他 缓存 机 制 。 

API 层 表示 为 应 用 程序 层 的 抽象 层 ， 该 层 将 隐藏 内 容 层 中 的 应 用 程序 逻辑 ， 并 通过 
HTTP REST API 服务 于 来 目 内 容 层 的 所 有 请 求 。 亚 马 逊 弹性 负载 平衡 机 制 以 此 管理 和 分 
发 流量 。 另 外 ， 该 API 层 还 负责 客户 端 请 求 路 由 、 过 滤 、 缓 存 、 身 份 验证 和 授权 。 


“二 
O 注意: 


Amazon ELB 用 于 管理 和 分 发 多 个 Amazon EC2 间 的 传 入 应 用 程序 流量 。 
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在 持久 层 中 ， 可 对 数据 存储 进行 配置 ， 如 绥 存 机 制 CMemcached EX Redis) ~ NoSQL 
DB 或 SQL DB。 除 此 之 外 ，AWS 还 提供 了 Relation DB 支持 ， 如 Amazon RDS. Amazon 
ElastiCache 服务 用 于 管理 缓存 机 制 。 相 应 地 ， 应 用 程序 层 包 含 了 实际 的 业务 逻辑 ， 并 连 
接 持 久 层 和 缓存 ; 此 外 ， 该 层 还 供 ELB 使 用 ,进而 扩展 EC2 实例 并 管理 来 目 API 层 的 传 
入 流量 。 

下 面 讨 论 AWS 上 的 男 一 种 典型 的 微服 务 染 构 。 在 上 述 架 构 中 ， 我 们 采用 了 不 同 的 
层 ， 例 如 内 容 交 付 层 、API 层 、 应 用 程序 层 和 持久 化 层 。 在 微服 务 架 构 中 ， 我 们 根据 特 
定 的 功能 将 应 用 程序 划分 为 独立 部 分 ， 而 不 是 多 个 技术 层 。 图 14.14 显示 了 AWS 上 微服 
务 应 用 程序 的 男 一 种 情况 。 


做 服务 数据 存储 
弹性 缓存 


弹性 负载 


图 14.14 


在 图 14.14 中 可 以 看 到 ， 用 户 界 面 类 似 于 之 前 的 内 容 交 付 层 ， 并 通过 Amazon S3 服 
务 处 理 静 态 内 容 。 

该 架构 采用 了 Amazon ECS (EC2 Container Service? 以 及 容器 运行 应 用 程序 。 该 服 
4 x $E Docker 容器 ， 并 可 方便 地 在 处 于 管理 状态 下 的 、Amazon EC2 实例 集群 上 运行 应 
用 程序 。 

另外 , 还 可 根据 客户 端的 传 入 流量 实现 Amazon ECS 的 伸缩 性 .相应 地 , Amazon ELB 
用 于 管理 多 个 容器 间 的 传 入 流量 ， 并 通过 REST API 将 流量 分 发 至 Amazon ECS 容器 中 。 

在 AWS 的 这 一 类 架构 中 ，Amazon ECS 消除 了 应 用 程序 基础 设施 这 一 特定 的 需求 
和 条件， 从 而 可 采用 基于 容器 技术 方案 部 普 服 务 。 关 于 容 吉 化 的 各 种 优点 ， 读 者 可 参考 第 
12 €. 

关 似 于 图 14.13 中 的 持久 层 ， 我 们 可 采用 多 种 数据 存储 方式 持久 化 微服 务 所 需 的 数 
Hi Ul Amazon RDS 和 Amazon ElastiCache。 其 中 ，Amazon ElastiCache 38 iX VJ ££ 2I fs ff 
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俏 或 云 缓存 优化 应 用 程序 的 性 能 ， 同 时 便于 部 着 、 操 作 和 扩展 。 
作为 中 央 存 储 库 ，Docker Hub 可 存储 所 有 的 Docker 镜像 ， 并 可 创建 会 有 或 私有 存储 
库存 储 此 类 Docker 镜像 。 稍 后 介绍 将 微服 务 发 布 至 Docker Hub 的 相关 步骤 。 
本 地 存 僻 库 的 议 置 和 运行 包括 以 下 步 又; 
(1) 在 Docker Hub 上 创建 一 个 账 尸 ， 对 应 网 址 为 https://hub.docker.com/。 
(2) 针对 Docker Hub 创建 一 个 行 储 库 (公有 或 私有 ) ， 如 图 14.15 Bras. 


Repositories 


public 


图 14.15 


在 图 14.15 中 可 以 看 到 ， 此 处 创建 了 3 个 存储 库 ， 分 别 为 dineshonjava/account, 
dineshonjava/customer 和 dineshonjava/doj。 其 中 ， 一 个 存储 库 为 私有 存储 库 ， 为 外 两 个 存 
EENAA TJE o 

(3) 利用 Docker 登录 命令 登录 Docker Hub， 如 图 14.16 所 示 。 


$5 docker login 
Login with your Docker ID to push and pull images from Docker Hub. If you don't 


wave a Docker ID. head over to https-:^/^hub.docker.com to create one. 
sername &dineshonjavua»: dineshonjava 

Password: 

Login Succeeded 


图 14.16 
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(4) 利用 Docker tag 标记 Docker 镜像 ， 如 图 14.17 Br. 


5 docker tag account—-seruice dineshonjaua/account :1.H 
图 14.17 


(5) 利用 Docker push 将 镜像 发 布 至 Docker Hub， 如 图 14.18 所 示 。 


$ docker push dineshonjava^/account :1.8 
The push refers to repository [docker.io^/dineshonjauva/account ] 


几 14.18 


(6) 访问 https://hub.docker.comyr/dineshonjava/account/tags/， 并 检测 刚刚 在 Docker 
云 中 发 布 的 镜像 ， 如 图 14.19 所 示 。 


PUBLIC REPOSITORY 


Tag Name Compressed | ast Updated 
Size 


6 minutes ago 


6 days ago 


图 14.19 


在 图 14.19 中 可 以 看 到 ， 此 处 发 布 了 Account 微服 务 的 两 个 标签 。 

本 节 讨 论 了 如 何 设置 和 使 用 Docker Hub 发 布 Docker 镜像 。 通 过 这 一 快捷 方式 ， 可 
采用 全 局 方式 访问 Docker 镜像 。 如 前 所 述 ， 这 里 从 本 地 机 器 问 Docker Hub 发 布 了 3 个 
Docker 镜像 。 接 下 来 考查 如 何 将 这 些 镜 像 下 载 并 运行 到 AWS EC2 实例 中 。 首 先 ， 需 要 
在 AWS EC2 实例 上 安装 Docker。 
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14.3 Æ AWS EC2 LÈ% Docker 


在 AWS EC2 实例 上 安装 Docker 较为 简单 。 首 先 需 要 利用 PuTTY 连接 EC2 实例 ， 
随后 齐 循 以 下 各 项 步骤 : 

(1) 运行 EC2 实例 并 通过 PuTTYgen 生成 私 钥 。 此 外 ， 还 需 下 载 之 前 生成 的 
dineshonjava.pem 文件 ， 这 将 生成 ineshonjava.ppk 文件 ， 并 用 于 连接 EC2 实例 (通过 
PRLEY2 à 

(2) 打开 PuTTY 并 连接 EC2 实例 。 在 Host Name 中 ， 利 用 Public DNS 连接 当前 
EC2 实例 ， 且 端口 为 22。 另 外 ， 加 载 身 份 验证 所 用 的 私 钥 文件 。 在 category 中 ， 选 择 
Connection | SSH | Auth 项 并 上 传 吴 份 验证 私 钥 文 件 ， 如 图 14.20 所 示 。 


B Terminal [| Options controlling SSH authentication 
i i Keyboard | 
i. Bell [ ] Bypass authentication entirely (SSH-2 only) 


— Features 


: Authentication methods 
E- Window 


A Mtempt authentication using Pageant 
Wr [ | Attempt TIS or CryptoCard auth (SSH-1) 
" Translation Attempt "keyboard4nteractive" auth (SSH-2) 
: | rt Authentication parameters 
E, a [_] Allow agent forwarding 
[_] Allow attempted changes of usemame in SSH-2 
Private key file for authentication: 


| | Browse... | 


图 14.20 


(3) 上 传 私 钥 文 件 dineshonjava.ppk， 并 单 击 Open 按钮 ， 将 连接 AWS EC2 实例 ， 
如 图 14.21 所 示 。 
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Using 


thennis 


在 图 14.21 中 可 以 看 到 ， 当 前 已 通过 PuTTY 连接 至 AWS EC2 实例 。 随 后 ， 即 可 方 
(EHE EC2 实例 上 安装 Docker. 
(4) AH FAIMA Docker. 


$ sudo yum install docker 


(5) 利用 下 列 命 令 司 用 Docker 服务 。 


S sudo service docker start 


ExSüp o jd) d £s d a 14.22 所 示 。 


f 
B u 


G O IT 


rt aAa m 

[D n 
BH nR h3 
rt oT 


L [A] m 


ED 


图 14.22 


(6) 上 述 命 令 将 在 EC2 实例 上 安装 Doucker。 接 下 来 , 利用 下 列 命 令 验 证 安装 结果 。 


S sudo docker version 


上 述 命令 运行 结 末 如 图 14.23 所 示 。 


| le E. la ^ p? g". (3 
i d - " adm T" pu k [wl 


ay a^ a Pala. B j J 
-] PCRs"URUI wd 'Z4 一 
"ied AL uua m cu^ 5; oom E G Wu 4l 


x/amdea4 


图 14.23 
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在 图 14.23 中 可 以 看 到 ，Docker 已 成 功 地 安装 在 AWS EC2 实例 上 。 接 下 来 讨论 如 何 
利用 Docker 镜像 在 AWS EC2 实例 上 运行 微服 务 。 


14.4 在 AWS EC2 上 运行 微服 务 


本 节 将 在 EC2 实例 上 设置 账户 和 客户 微服 务 ， 相 关 示 例 中 还 将 使 用 到 Spring Boot 
2.0， 具 体 步 又 如 下 : 
CD 利用 下 列 命 令 安 装 Java 8 和 EC2 实例 。 


wget -c --header "Cookie: oraclelicensezaccept-securebackup-cookie 


此 外 ， 也 可 引用 下 列 链接 


http://download.oracle.com/otn-pub/java/jdk/8u131- b11/ 
d54c1d3a095b4ff2b6607d096fa80163/jdk-8u131-1linux-x64.tar.gz 


ERMAT FE jdk-8u131-linux-x64.tar.gz 文件 。 通 过 下 列 命 令 可 加 载 该 文件 : 
$ sudo tar -xvf jdk-8ul131l-linux-x64.tar.gz 


(20 FHRA JAVA HOME 和 了 PATH 环境 变量 ， 如 下 所 示 : 


$ JAVA HOME-/home/ec2-user/jdk1.8.0 131 
$ PATH-/home/ec2-user/jdk1.8.0 131/bin:$PATH 
$ export JAVA HOME PATH 


利用 如 图 14.24 所 示 的 命令 可 检测 Java 版 本 。 


nized mode) 


图 14.24 


(3) 可 以 看 到 ， 在 EC2 实例 上 设置 了 Java 8。 接 下 来 在 EC2 实例 上 运行 微服 务 ， 并 
依次 执行 下 列 命 令 : 
S sudo docker run -p 80:8761 dineshonjava/doj:1.0 


$ sudo docker run -p 8181:6060 dineshonjava/account:1.0 
S sudo docker run -p 8282:6060 dineshonjava/customer:1.0 
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(4) 在 浏览 器 中 打开 下 列 URL， 进 而 验证 服务 的 工作 状态 。 


http://ec2-18-219-255-59.us-east-2.compute.amazonaws.com/ 


注意 ， 我 们 将 使 用 EC2 实例 的 公共 了 或 公共 DNS. 该 URL 将 打开 Eureka Dashboard, 
如 图 14.25 所 示 。 


— Eureka 


é 


(> | O ec2-18-219-255-59.us-east-2.compute.amazo... * | D œ 6 D 4 


DS Replicas 


Instances currently registered with Eureka 
Application AMIs Availability Zones Status 
ACCOUNT-SERVICE n/a (1) (1) 


CUSTOMER-SERVICE n/a (1) (1) 


General Info 


total-avail-memory 64mb 


图 14.25 


在 图 14.25 中 可 以 看 到 , 此 处 利用 运行 于 AWS EC2 实例 上 的 Eureka 服务 器 注册 了 两 
项 微服 务 ， 即 Account 和 Customer. 


(5) 通过 下 列 命令 并 使 用 Docker 镜像 将 Customer 微服 务 部 车 至 AWS EC2 E. 
S sudo docker run -p 80:6060 dineshonjava/customer:1.0 
(6) 在 浏览 器 中 访问 下 列 URL 并 测试 当前 微服 务 。 


http://ec2-18-219-255-59.us-east-2.compute.amazonaws.com/customer/1001 


这 将 显示 ID 73 1001 的 客户 的 详细 信息 ， 如 图 1426 所 示 。 
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y 2 ec2-18-219-255-59.us-e: x WW Y 


Eu (D ec2-18-219-255-59.us-east-2.compute.amazonaws.com/customer/ 1001 


customerId: 1001, 

customerName: Arnaw Rajput”, 

mobile: "54312XX223", 

email: "arnavxxxümail.com", 

city: “Noida”, 

- account: [ 
wes 

accountlId: 60, 
balance: 1, 
customerId: 8, 
accountType: "UNKNOWN ACCOUNT TYPE", 
branchCode: "UNK", 
bank: "FALLBACK BANK" 


图 14.26 
14.05 A X d 2 


本 章 讨 论 了 多 种 AWS 服务 以 及 AWS 上 的 微服 务 架 构 。 其 间 , 我 们 设置 了 AWSEC2 
实例 , 并 在 EC2 实例 上 安装 了 Java 8 和 Docker。Docker Hub 提供 了 一 种 较为 简单 的 方法 ， 
可 将 微服 务 的 Docker 镜像 注册 至 服务 器 上 。 在 本 章 中 ,我 们 将 3 个 微服 务 注 册 至 Docker 
Hub E. 

最 后 ， 我 们 在 AWS EC2 实例 上 安装 了 Docker， 从 Docker Hub 中 获取 全 部 的 Docker 
镜像 ， 并 将 此 类 镜像 部 闭 至 EC2 实例 上 。 

第 15 草 将 讨论 如 何 监视 分 布 式 系统 的 日 志 。 
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对 于 企业 级 应 用 程序 来 说 ， 监 视 和 日 志 机 制 十 分 重要 ， 特 别 是 处 理 涉 及 多 种 技术 的 
微服 务 分 布 式 应 用 程序 时 。 考 虑 到 应 用 程序 部 普 的 分 布 式 行为 ， 个 体 微 服务 应 用 程序 的 
日 志和 监视 机 制 是 一 项 颇具 挑战 性 的 工作 。 在 分 布 式 应 用 程序 中 ， 多 项 微服 务 共同 运行 
于 多 台 机 器 上 ， 因 而 不 同 微服 务 生成 的 日 志 内 容 将 难以 实现 端 到 端 事务 的 跟踪 。 

此 外 ， 我 们 还 将 详细 介绍 构建 分 布 式 系统 的 一 些 最 佳 实践 ， 以 及 服务 的 性 能 监控 ， 
并 为 分 布 式 应 用 程序 引入 使 用 Elastiesearch/Logstash/Kibana 堆栈 的 日 志 聚 合 机 制 。 

在 阅读 完 本 章 后 ， 读 者 将 能 够 较 好 地 理解 如 何 监视 一 个 分 布 式 系统 ， 以 及 如 何 聚 合 
分 布 式 应 用 程序 的 个 体 微 服务 生成 的 分 布 式 日 志 消 奶 。 

本 章 主 要 涉及 以 下 主体 : 
微服 务 染 构 中 所 面临 的 与 日 志 机 制 相关 的 挑战 。 
微服 务 的 集中 日 志 机 制 。 

使 用 ELK 栈 的 日 志 聚 合 。 
使 用 Sleuth 的 请 求 跟踪 。 
使 用 Zipkin 的 请 求 跟踪 。 


LLLLLL 
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容器 的 监视 行为 是 指 在 不 同 的 环境 下 监测 微服 务 容器 的 性 能 。 监 视 机 制 是 性 能 优化 
和 改进 的 首要 步 又。 


15.2 ”日志 机 制 所 面临 的 挑战 


正如 我 们 所 知 ， 日 志 对 于 调试 和 审计 业务 指标 的 任何 应 用 程序 都 非常 重要 ， 因 为 日 
志 包 含 了 需要 分 析 的 重要 信息 。 因 此 ， 日 志 记 录 是 编写 文件 的 过 程 ， 日 志 是 来 自 服 务 器 
上 运行 的 应 用 程序 的 事件 流 。 妆 在 应 用 程序 中 实现 日 志 记 录 时 ， 存 在 多 种 可 用 的 框 染 ， 
如 Log4j. Logback 和 SLF4J。 在 NEE 传统 应 用 程 订 中 ， 也 存在 多 种 可 用 的 日 忘 框 淋 。 

在 J2EE 应 用 程序 中 , 大 多 数 日 志 编 写 至 控制 台中 或 者 磁盘 空间 的 文件 系统 中 。 对 此 ， 
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我 们 需要 留意 磁盘 空间 , 并 且 须 实现 一 个 Shell 脚本 , 以 便 在 特定 时 间 之 后 回收 日 志文 件 ， 
以 避免 日 志 填 满 所 有 磁盘 空间 。 因 此 ， 对 于 应 用 程序 来 说 ， 考 虑 到 人 厂 盘 UO 开销 ， 日 志 处 
理 的 一 种 最 佳 实践 是 避免 在 生产 环境 中 编写 不 必要 的 日 志 。 人 磁盘 IO 可 减缓 应 用 程序 的 执 
行 速度 ， 同 时 也 会 占据 磁盘 空间 ， 还 可 能 导致 生产 服务 器 上 的 应 用 程序 停机 或 终止 。 

HAEA CUN Log4j. Logback 和 SLFAJO 提供 了 相应 的 日 忘 级 别 (INFO、DEBUG、 
ERROR) 并 在 运行 期 内 控制 日 志 ， 以 及 限制 所 输出 的 相关 内 容 。 这 一 类 日 志 框 架 还 可 修 
改 日 志 级 别 并 在 运行 期 内 进行 配置 ， 进 而 可 在 应 用 程序 中 对 日 志 记 录 子 以 控制 。 有 时， 
我 们 无 法 限制 某 些 日 志 条 目 ， 因 为 它们 是 业务 分 析 和 理解 应 用 程序 行为 时 所 必需 的 。 

在 传统 的 J2EE 单 体 应 用 程序 中 ， 可 以 避免 磁盘 容 间 的 问题 ,还 可 以 方便 地 扩展 用 于 
日 志 记 录 的 硬件。 但 是 当 我 们 从 传统 的 J2EE 单 体 应 用 程序 转移 到 基于 云 的 分 布 式 应 用 程 
序 时 会 友 生 什么 呢 ? 云 部 著 并 不 会 事先 绑 定 相关 机 需 设 备 ， 分 布 式 云 系统 可 在 多 人 台 虚 拟 
机 和 容器 上 进行 部 署 。 

正如 在 第 12 章 中 所 讨论 的 ， 容 器 (如 Docker) 的 生命 周期 较为 短暂 。 因 此 ， 我 们 不 
能 依赖 容器 及 其 磁盘 的 持久 化 状态 ， 因 为 当 容 器 俘 止 或 重新 局 动 时 ， 它 将 丢失 写 入 晶 面 
的 所 有 日 志 。 

在 微服 务 架 构 中 ， 分 布 式 应 用 程序 运行 于 多 台 人 处 于 隐 离 状态 的 机 器 (虚拟 机 或 真实 
设备 ) E, KERE, 日志 文件 将 在 所 有 的 机 器 上 独立 生成 ， 因 而 无 法 跟踪 这 些 文件 的 
站 到 站 事务 一 一 它们 被 多 个 微服 务 处 理 ， 如 图 15.1 所 示 。 
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图 15.1 


在 图 15.1 中 可 以 看 到 ， 微 服务 运行 于 独立 的 基础 设施 和 机 器 设备 上 ， 且 每 个 微服 务 
均 癌 本 地 机 需 生 成 日 过 。 假 设 东 项 任务 称 为 微服 务 A， 随 后 是 微服 务 E 和 微服 务 F。 
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此 ， 微 服务 A、 微 服务 E 和 微服 务 运行 于 不 同 的 机 器 上 ， 且 每 项 服务 针对 当前 任务 在 
不 同 的 机 器 设备 上 编写 不 同 的 日 志 内 容 。 对 于 微服 务 应 用 程序 中 特定 的 端 到 端 任务 ， 这 
将 难以 调试 和 分 析 日 志 内 容 。 因 此 ， 需 要 在 服务 级 别针 对 日 志 聚 合 设置 相关 工具 。 接 下 
来 将 讨论 如 何 针对 微服 务 分 布 式 应 用 程序 实现 集中 日 志 解 决 方案 。 


153 ”微服 务 架 构 的 中 心 日 志方 案 


HAEA (如 Log4、Logback 和 SLF4J)〉 人 针对 每 个 微服 务 应 用 程序 均 提供 了 日 志 记 
录 功 能 。 对 此 ， 需 要 人 条 种 工具 并 可 将 来 目 多 个 微服 务 的 所 有 日 志 聚 合 到 本 地 虚拟 机 的 中 
心 位 置 ， 并 在 日 志 消 轧 上 进行 分 机 。 同 时 ， 该 方案 需要 提供 相应 的 日 志 记 录 以 跟 踩 器 到 
峭 事 务 。 集 中 日 志方 案 可 消除 本 地 磁盘 空间 上 的 依赖 和 关系， 同时 可 长 久保 持 日 志 内 容 以 
供 后 续 分 析 使 用 。 

据 此 ， 所 有 日 志 消 旦 需要 存储 于 攻 个 中 心 位 置 处 ， 而 不 是 每 个 和 做 服务 的 本 地 机 器 设 
备 上 。 该 方案 在 日 志 存 储 和 服务 执行 环境 之 间 提 供 了 菏 种 分 离 策 略 。 对 此 ， 我 们 可 采用 
东 种 大 数据 技术 ， 如 HDFS， 存 储 大 量 的 日 志 消 轧 。 因 此 ， 实 际 的 日 志 被 写 入 本 地 机 器 ， 
然后 从 执行 环境 友 壕 到 中 央 大 数据 存储 中 。 

图 15.2 显示 了 针对 铀 服务 分 布 式 应 用 程序 的 集中 日 志 解 决 方案 。 


日 志 流 处 理 器 


图 15.2 
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集中 日 志方 案 或 者 涉及 多 个 协同 工作 的 组 件 ， 其 中 包括 以 下 方面 。 

D HÈR: 表示 为 微服 务 生成 的 日 志 消 息 。 在 某 个 微服 务 中 ， 可 采用 任何 日 志 框 
架 生 成 日 志 流 ， 如 Log4j、Losgback 和 SLF4J. 

E 志 传 输 : 该 组 件 负责 采集 来 自 不 同 机 器 的 、 多 项 微服 务 所 生成 的 所 有 日 志 流 。 
日 志 传 输 将 日 志 消 息 发 送 至 中 央 存 储 处 ， 如 数据 库 ， 随 后 推送 至 仪表 盘 或 者 针 
对 实时 分 析 的 任意 流 处 理 单 元 中 。 

Logstash 是 一 个 针对 集中 日 志 的 较为 流行 的 日 志 传输 工具 。 该 工具 可 用 于 采集 、 传 
输 来 自 多 个 分 布 式 微服 务 的 日 志文 件 。Logstash 的 工作 方式 类 似 于 一 个 代理 ， 它 接受 来 
目 多 个 端点 的 日 忘 流 ， 并 将 这 些 日 志 流 汇聚 到 其 他 目的 地 (Elasticsearch、HDFS 或 其 他 
数据 库 ) 。 

HEAR CU Log4j 和 Logback) 可 用 于 将 源 目 Spring Boot WARS A H ER ERIS 
至 Logstash 处 。 随 后 ，Logstash 将 把 此 类 日 志 消 息 发 送 至 所 连接 的 日 志 存 储 中 。 本 章 稍 
后 将 过 过 相 天 示例 对 Logstash 加 以 讨论 。 

诸如 Fluentd 和 Logspout 等 其 他 工具 也 与 Logstash 类 似 ， 此 类 工具 更 加 适用 于 不 同 
的 环境 和 基础 设施 ， 如 Docker 环境 。 

2 ”日志 存 储 : 对 于 实时 分 析 来 说 , 这 可 视 为 所 有 日 志 流 存储 的 中 央 位 置 , 如 NoSQL 

数据 库 和 HDFS. 

稍 后 将 通过 具体 示例 讨论 日 志 存 储 。 例 如 ，Elasticsearch 可 用 于 存储 实时 日 志 消 息 。 
Elasticsearch 是 一 类 文本 搜索 技术 ， 客 尸 问 可 通过 基于 文本 的 案 引 进行 查询 。 

HDFS 可 用 于 存储 归档 日 志 消 息 ， 其 他 元 数据 ， 如 事务 计数 ， 则 可 存储 于 MongoDB 
或 Cassandra 中 。 最 后 ， 还 可 针对 离线 日 志 处 理 采 用 Hadoop Map-Reduce 程序 。 

2 HERMLE: 这 是 一 个 用 于 快速 决策 的 实时 日 志 分 析 引 擎 ， 并 可 同日 志 仪 表 

盘 友 送 相 关 信 息 。 此 外 ， 它 还 可 处 理 并 友 送 警告 信息 ， 并 通过 相关 指 施 处 理 目 
修复 系统 中 的 问题 。 

菏 些 时 候 ， 我 们 需要 构建 一 个 实时 系统 ， 并 可 动态 地 分 析 日 志 流 ， 此 外 ， 还 可 在 天 
健 情况 下 制定 相关 决 人 并 进行 目 我 修复 ， 以 对 问题 加 以 处 理 。 

XIF, 可 采用 Flume 和 Kafka 这 一 组 合 方 式 ( 基 于 Storm 和 Spark Streaming) 。 
日 志 流 处 理 器 (Storm 或 Spark) 可 实时 处 理 来 目 Kafka 的 全 部 去 日 志 消 上 忠 ， 并 于 随后 将 
ERIZE Elasticsearch 或 其 他 日 志 存 储 中 。 对 此 ， 可 使 用 Log4j 日 志 框 架 ， 其 中 包含 了 
Flume Appender 采集 日 志 消 息 ， 并 将 其 有 友 送 至 分 布 式 Kafka 消息 队列 。 

对 于 流 处 理 ,，Spring Framework 提供 了 多 种 解决 方案 , 如 Spring Cloud Stream. Spring 
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Cloud Stream 模块 和 Spring Cloud Data Flow. 

2 日 志 仪 表盘 : 这 是 集中 日 志方 案 的 日 志 可 视 化 组 件 ， 将 以 图 形 或 表格 形式 展示 

日 志 的 分 析 报 告 。 日 志 仪 表盘 对 于 业务 团队 的 决策 者 来 说 十 分 有 用 。 

IE, ERR BIDEN Su] Ba KL. 4 Kibana. Graphite 和 
Grafana。 其 中 ， 作 为 日 志 仪 表盘 ，Kibana 可 在 Elasticsearch 数据 存储 之 上 用 于 日 志 分 析 。 

综 上 所 述 ， 这 一 类 分 布 式微 服务 应 用 程序 的 日 志 实 现 ， 并 不 强调 将 日 志 写 入 本 地 机 
di MIRARE T |R] HH o 

在 集中 日 记 方 案 中 ， 需 要 遵循 相应 的 日 忘 消 因 标准 。 例 如， 日志 消 奶 须 包 含 上 下 文 、 
消息 和 相关 JIJD。 其 中 ， 上 下 文 信息 表示 为 卫 地 址 、 用 户 信息 、 处 理 细节 内 容 、 时 间 惟 和 
日 志 类 型 ， 相应 地 ， 消 息 则 表示 为 简单 的 文本 内 容 ; 相关 ID 则 针对 微服 务 间 的 特定 任务 
HH F SES? $1] H EP] ER ER o 

T ds A IR] SZ FHREEHE ARRA UCN, (METER TIU SEXRHRIT SBHGESE. Mob e 
种 预制 工具 也 可 提供 新 到 疡 的 集中 日 志方 条 ， 如 Graylog 和 Splunk. 3X V, Graylog 十 一 
个 开源 日 志 管 理工 具 ， 并 使 用 Elasticsearch FA H BF; GELF 库 则 可 用 于 Log4j 日 志 
流 处 理 ，Splunk 则 是 男 一 个 商业 日 志 管 理工 具 。 

许多 云 日 志 服 务 可 以 作为 SaaS 解决 方案 使 用 。Loggly、AWS CloudTrail、Papertrail、 
Logsene、Sumo Logic. Google Cloud Logging 和 Logentries 则 是 云 日 忘 方案 的 相关 应 用 
示例 。 

接 下 来 讨论 如 何 利用 Elasticsearch/Logstash/Kibana 实现 目 定 义 的 集中 日 志方 案 。 


15.3.1 基于 ELK 栈 的 日 志 聚 合 


之 前 曾 讨 论 了 针对 分 布 式微 服务 应 用 程序 的 集中 日 志 解 决 方案 ， 相 关 组 件 〈 如 日 志 
流 、 日 志 传输 、 日 志 存 储 和 日 志 仪 表盘 ) 协同 工作 后 即 可 面 同 分 布 式 应 用 程序 提供 集中 
日 志方 案 ， 进 而 部 普 至 容器 环境 或 虚拟 /物理 机 器 上 。 

Elasticsearch、Logstash 和 Kibana LE (ARJ ELK 栈 ) 在 分 布 式 应 用 程序 中 提供 
T Fhmn B) E ERR. MT BEL BEIDE. ELK 是 较为 第 见 的 架构 之 一 。 
图 15.3 zs f. REP Bos IS UAR MJ. 

在 图 15.3 中 可 以 看 到 ， 微 服务 A. B. C. DER f. LogAj/Logback ENH as; 3f 
使 用 Logback Appender 将 日 志 内 容 直 接 写 入 Logstash P. HR], Logstash 的 工作 方式 类 
似 于 日 志 流 和 日 志 存 储 间 的 代理 ， 进 而 将 日 志 消 息 发 送 至 Elasticsearch 。 相 应 地 ， 
Elasticsearch 工具 将 以 文本 索引 形式 保存 有 所 生成 的 日 志 。 随 后 ，Kibana 将 使 用 此 类 索引 ， 
其 工作 方式 类 似 于 一 个 日 志 仪 表盘 ， 并 显示 日 志 分 析 报 告 。 
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appenders 


微服 务 A 


Logbac K/L og4j 
appenders 


微服 务 B | Elasticsearch 


(存储 ) 


Logback/Log4j 
| appenders 


Logback/Log4j 
appenders 


图 15.3 


在 ELK 栈 工具 示意 图 中 可 以 看 到 ， 多 个 微服 务 A、B、C 4I D 使 用 Log4j/Logback 
Ah Hsu. 并 使 用 Logback 附加 程序 将 日 志 流 直接 写 入 全 Logstash，Logstash 7524 His 
法 和 日 忘 存储 之 则 的 代理 ， 问 Elasticsearch 发 这 日 忘 消息 。Elasticsearch 工具 以 基于 文本 
索引 的 形式 保存 生成 的 日 志 。Kibana 将 使 用 这 些 索 引 ， 并 作为 一 一 个 日 志 仪 表 极 来 显示 日 
记分 析 报 告 。 

下 列 步 又 将 针对 自 定义 集中 日 志 机 制 实现 ELK 栈 。 

步骤 1: 安装 集中 日 志方 案 的 全 部 3 个 组 件 ， 也 就 是 说 ， 下 载 Elasticsearch、Kibana 
和 Logstash， 并 将 其 安装 至 独立 服务 器 上 ， 即 ELK 服务 器 。 

(1) Z% Elasticsearch 

Elasticsearch 适用 于 所 有 平台 ， 如 Linux 或 Windows。 可 访问 https://www.elastic.co/ 
对 其 进行 下 载 。 这 里 ， 我 们 将 使 用 Windows 系统 ， 因 而 有 顷 态 问 https://www.elastic.co/guide/ 
en/elasticsearch/reference/current/zip-windows.html 进行 下 载 ， 随 后 解压 Elasticsearch。 在 
Linux 系统 中 ， 可 利用 apt 或 apt 并 从 包 存 储 库 中 安 闻 Elasticsearch.. f; ZzXx 6/8, Pii 
过 下 列 命令 并 运行 Elasticsearch 服务 对 其 进行 测试 。 


.bin/elasticsearch.exe 


上 述 命令 的 执行 结果 如 图 15.4 所 示 。 
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[2018—85—85T801 :83:39,888 JL INFO ]lLo.e.t.IransportServuice ] E. xGM-qpl publish ad 
dress 1127.8.H.1:973H8H»?. bound addresses 1127.8.H.1:93HH5., iL::11:93BHH5 
[28018—85—B5TH1 : 83 : 43, 9641LINFO ]Lo.e.c.s.MasterServuice ] [. xGM-uypl zen-disco- 


elected-as-master «&[8] nodes joined», reason: new master i xGM-ugp»i. xGM-qp3RI C87 
nkb5TICRGQ? 4VUBPZuUlGRjU KPTZHhgewuQ?i1127.8.0.15»4127.0.8.1:738HB7 

[2818—85—85TH81:83:43,B8H8 ILINHFO ]lL[o.e.c.s.GlusterfipplierSeruicel [. xGM-qpl neu. ma 
ster i xGM-up;i - xGM-qp3RIC89nk5TICRGQ»4UBPZuUlGRjU KPIZSHhgeuQ?4127.8.8.154127.H. 
B.1:93BB». reason: apply cluster state from master [master i. xGM-qugp?&. xGM- qp3RI 
CS9nk5TICRGQ?CUBPZul GRAM - HKPTZzHhgeuQ?*i1127.B8.0.15»41127.8.8.1:9238B8» committed versi 


on [11 source [zen-disco-elected-as-master [BB] nodes joined?» ]1ll? 

[28018—45—85T81 :83:43.968IL[INFO lL[o.e.g.GatewvayService ] EL xGM-qpl recovered 
[8] indices into cluster state 

[28018—85—85T81:83:44,387 ILIMHFO lLo.e.h.n.MettudHttpSeruerIransport] [, xGM- gol, pu 
blish address {127.0.9.1 :92007. bound addresses {4127.0.0.1:92002,. [::11:920 
[2018—55—85T81:83:44.387 ILINFO jlo.e.n.Node ]L  xGM- qp 1 started. 
[2018—85—85T81 :11:57.137]LINFO ]Lo.e.c.m.MetaDataCreateIndexSeruicel [. xGM-qp1 I 
logstash-2818.585.5004] creating index, cause LautoCbulk api»1l1. templates Llogstash 
]. shards [51]^/I[I11. mappings L[ default 1] 


图 15.4 


在 图 15.4 中 可 以 看 到 ，Elasticsearch 运行 于 9200 端口 上 上。 在 浏览 器 中 输入 
http://localhost:9200/ 可 对 其 进行 访 | 所 示 。 


ocalhost:9200 


《> |) localhost:9200 


name: xGM-qp 

cluster name: 

cluster uuid: 

- version: f 

number : 
build hash: 
build date: 
tare uni an fa ls je, 
lucene version: "7.2.1", 
minimum wire compatibility version: 
minimum index compatibility version: 


: 7 : 
TN : 


tagline: 


Elasticsearch 11 B 33 [H] 9i O 9200 RIŽ HTTP 请 求 而 运行 。 
(2) Z% Logstash 
关羽 于 Elasticsearch， 可 访问 https://www.elastic.co/downloads/logstash F £X Logstash. 
同样 ，Logstash 运用 于 所 有 平 侣 。 此 处 将 使 用 Windows 系统 ， 因 而 可 针对 诅 系 统 下 载 ZIP 
文件 并 随后 对 其 进行 解压 。 在 CLI 上 运行 下 列 命令 , 即 可 在 当前 机 磊 上 运行 Logstash 服务 。 


bin/logstash -f logstash.conf 
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JH, logstash.conf 表示 为 当前 配置 文件 ， 
(3) S Kibana 
Kibana 同样 适用 于 所 有 和 平台， 该 者 可 访问 https;//www.elastic.co/downloads/kibana 对 
其 进行 下 载 ， 针 对 Windows 系统 选择 对 应 文件 ， 随 后 执行 解压 操作 。 
UR m HENX Kibana 配置 ， "T FEARS RIT AF config/kibana.yml 文件 ， 并 根据 应 
用 程序 基础 设施 目 定 义 已 有 信息 。 最 后 ， 通 过 下 列 命令 即 可 运行 Kibana. 


bin/kibana 


上 述 命令 的 运行 结果 如 图 15.6 Pr. 


相 后 将 过 过 上 其 体 示 例 对 其 加 以 讨论 。 


D:“personal data*book*ELK*«kibana-6.2.4-windows-x86. 64«bin»kibana.bhat 
[ ]I 


19:35:55.6411 [ 


ninitialized to green 一 Head 


[19:35:55.788] [ 


]Iplugin:kibanaf?6.2.41] Status changed from u 


ILlplugin:elasticsearchi?6.2.41] Status changed 


from uninitialized to 


19:35:55.8831 [ 


uninitialized to green 
[19:35:55.819] 
uninitialized to green 
[19:35:58.2H8 ] 
uninitialized to gree 


[19:35:58.239] 
[19:35:58.697] 


from vellow to green 


在 图 15.6 中 可 以 看 到 ， 
中 访问 http://localhost:5601 


E 


步骤 2. 通过 


ibana 


一 Waiting for Elasticsearch 
llplugin:console8?6.2.4] Status changed from 


]EIplugin:metrics?6.2.41] Status changed from 


Illplugin:timelioni466.2.41] Status changed from 
n — Ready 
[ ]I ] Server running at http:/^/localhost:56H1 


L IL 


Ilplugin:elasticsearchi6.2.41] Status changed 


一 Ready 
图 15.6 
驮 认 状 态 下 ，Kibana 运行 于 5601 端口 上 。 接 下 来 在 浏览 


, WB 15.7 所 示 。 


(> | © lacalhost:56C 


kibana Add Data to Kibana 


Use these solutions to quickly turn your data 


Discover 
Visualize 
Dashboard 


Timelion APM 


Dev Tools lects in- 
depth pennant ce metrics and 


om inside 


APM automatically col 


Management errors 


applications 


图 15.7 


Ys Jp A6 Hd aM Ceureka. account 和 customer 服务 ) 
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此 处 采用 slf4j 生成 日 志 消 息 。 下 面 在 AccountController 和 CustomerController 控制 器 类 中 
SAL F A H S: 


地 ， 


import org.slf4].Logger; 
import org.slf4j.LoggerFactory; 


aRestController 

public class AccountController { 

private static final Logger logger - 
LoggerFactory.-getLogger (AccountController.class); 
@GetMapping (value = "/account") 

public Iterable«Account» all ()í 
logger.info("Find all accounts information "); 
return accountRepository.findAll(); 


} 
在 上 述 代 码 片 段 中 ， 我 们 同 AccountController 的 所 有 请 求 方法 中 加 入 了 有 日志。 类 似 
此 处 还 定义 了 CustomerController， 如 下 所 示 : 


import org.slf4j.Logger; 

import org.slf4j.LoggerFactory; 

aRestController 

public class CustomerController 1 

private static final Logger logger - 
LoggerFactory.getLogger(CustomerController.class); 

@GetMapping (value = "/customer/ícustomerId]") 

public Customer findByAccountId (@PathVariable Integer customerId){ 
Customer customer = customerRepository.findByCustomerId (customerId); 
customer.setAccount (accountService.findByCutomer (customerIld)); 
logger.info("Find Customer information by id: "-«customerId); 

return customer; 


} 
} 
可 以 看 到 ， 在 CustomerController 的 每 个 请 求 方法 中 ， 我 们 添加 了 包含 信息 级 别 的 日 
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IK BR o 
步骤 3: 癌 每 个 微服 务 的 Maven 配置 文件 中 添加 Logstash Maven KERZ, n FB: 
<dependency> 


«groupId»net.logstash.logbackc/groupId» 
«artifactlId»logstash-logback-encoderc«/artifactld» 
«version»5.0«/version» 


</dependency> 


f£ ERRER ErBPRuIEUE SU, RIII f Logstash 依赖 项 ， 以 便 使 用 pom.xml 文件 
在 所 有 做 服务 中 将 Logback 集成 到 Logstash 中 。 

步骤 4: 由 于 对 Logstash 添 加 了 Appender， 因 而 需要 重 载 默认 的 Logback 配置 。 对 
此 ， 可 在 src/main/resources 中 添加 新 的 logback.xml 文件 。 考 查 下 列 添加 至 每 个 微服 务 中 
的 logback.xml 文件 。 


€2xml version "1.0" encoding" UTF-8"?> 

<configuration> 

«include 
resource-"org/springframework/boot/logging/logback/defaults.xml"/» 
«include resource-"org/springframework/boot/logging/logback/ 
consoleappender.xml" /» 

«appender name-"'"stash" 
class-"net.logstash.logback.appender.LogstashTcpSocketAppender"- 
«destination»localhost:4567«/destination» 

“1 encoder r5 required > 

«encoder class-"net.logstash.logback.encoder.LogstashEncoder" /» 
«/appender» 

«root level-"INFO"-» 

«appender-ref ref-"CONSOLE" /> 

«appender-ref ref-"stash" /» 

<J roots 


«/configuration-» 


logback.xml 文件 重 载 了 默认 的 Logback 配置 。 目 定义 Logback 配置 文件 中 包含 了 新 
的 TCP 套 接 字 Appender， 并 将 所 有 的 日 志 消 息 发 送 至 Logstash 服务 中 ， 该 服务 运行 于 
4567 端口 上 。 因 此 ， 需 要 将 该 端口 配置 至 Logstash 配置 文件 中 ， 这 将 在 步骤 5 中 看 到 。 
更 为 重要 的 是 ， 此 处 添加 了 一 个 编码 夫 。 

步骤 5: 创建 Logstash 配置 文件 , üÜül F Hr: 

input { 


tcp 1 
pört -> 4567 


第 15 章 生产 服务 监视 和 最 佳 实践 。305 。 


host => localhost 

} 

} 

output 1 

elasticsearch { 

hosts => |["localhost:9200"] 


} 

stdout f{ 

codec => rubydebug 
| 

} 


在 上 述 logstash.conf 配置 文件 中 , 我 们 配置 了 输入 和 输出 内 容 。 Logstash 将 通过 4567 
亲口 从 套 接 字 接 收 输 入 内 容 ， 同 时 还 配置 了 输出 内 容 。Elasticsearch 则 在 9200 žm O E-JJH 
LUH o AIh, stdout 为 可 选项 并 针对 调试 功能 加 以 充 四 。 

步骤 6: 从 各 上 自 的 安装 文件 夹 中 运行 有 有 服务 ， 即 Elasticsearch、Logstash 和 Kibana， 
如 下 所 示 : 

./bin/elasticsearch 


./bin/kibana 
./bin/logstash -f logstash.conf 


步骤 7: 运行 所 有 的 示例 微服 务 ， 如 Account 微服 务 和 Customer WARS» Customer 
WARS TIIE H w h E Logstash 中 。 

步骤 8: 在 浏览 器 中 访问 http://localhost:5601， 并 打开 Kibana 仪表 盘 ， 进 入 设置 项 并 
创建 一 个 索引 模式 ， 如 图 15.8 所 示 。 


Create index pattern 


Kibana uses index patterns to retrieve data from Elasticsearch indices for things like visualizations. 


Step 1 of 2: Define index pattern 


Index pattern 


You can use a * as a wildcard in your index pattern 


OMM MEME EMT M DNE 和 
ToU Can t usc empty spaces or tne characte 5 X, F, ? ;Q 0, |. 


Your index pattern can match any of your 2 indices, below. 
logstash-2018.05.04 


logstash-2018.05.05 


图 15.8 
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在 图 15.8 中 可 以 看 到 ， 此 处 设置 了 索引 logstash-*. 
步骤 9: Xe TE SE PR rn 的 Discover 选项 ， 将 显示 H TNR, ae | 15. 9 BIZ. 


区 Discover - Kibana x - 


c G © localhost:56C /app/kibana**/discover? g=(refreshlnterva.. 


" kibana 


Discover 


May 6th 2018, 00:58:10.574 - May 6th 2018, 01:13:10.574 — | Auto 


Visualize 


Dashboard ; —p- — 


01:03:00 01:05:00 
Timelion (Dtimestamp per 30 seconds 


Dev Tools 
source 


Management May 6th 2018, 01:12:22.984 message: ["Gtimestamp":"2018-05-06T01:12:22.949« 
05:30" ,"&version : 1"," message": Resolwing eurek 
a endpoints wia configuration" ,"logger. name" :"co 
m. netflix. discovery. shared. resolver. aws.Conf31gCl 


usterResolver”,"thread_name":"AsyncResolver-boot 


May 6th 2018, 01:12:12.848 message: {"@timestamp":"2018-05-06T01:12:12. 820+ 
05:30","Byersion":"1","message" :" Find Customer 1 
nformation by id: 1001","logger. name":"com.d1nes 
honjava. customerservice.controller.CustomerContr 


oller","thread name":"http-n1io-6161-exec-7"," lev 


May 6th 2018, 01:12:12.454 message: ["Gtimestamp":"2018-05-06T01:12:12.452« 


Oo Collapse 05:30","Bversion :" l","message" :" Find all Accoun 


图 15.9 


在 图 15.9 所 示 的 Kibana UI 中， 日 志 消 息 在 Kibana 仪表 盘 上 了 予以 显示 。Kibana 利用 
日 志 消 恩 构 建 了 对 应 的 表格 和 图 形 信息 。 


15.3.2 使 用 Sleuth 的 请 求 跟踪 


我 们 已 经 了 解 了 如 何 将 分 布 式 和 碎片 化 的 日 记 记 录 转 化 为 集中 式 日 志 记 录 体 系 结 
构 。 据 此 ， 我 们 解决 了 与 分 布 式 日 志 相 关 的 问题 ， 并 在 中 央 存 储 中 聚合 所 有 的 日 志 内 容 。 
这 里 的 问题 是 ， 如 何 为 喘 到 病 事 务 的 单个 请 求 跟 踪 这 些 日 志 呢 ? 这 里 ， 全 部 事务 分 布 于 
微服 务 中 ， 为 了 从 问 到 端 中 对 其 进行 跟踪 ， 我 们 需要 使 用 到 一 个 关联 IDs — [JETER ER 
请 求 在 微服 务 中 的 行进 方式 ， 特 别 是 对 所 调用 的 微服 务实 现 一 无 所 知 时 。 
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Spring Cloud 中 包含 了 一 个 Spring Cloud Sleuth 库 ， 并 有 助 于 解决 此 类 问题 。Spring 
Cloud Sleuth 针对 每 条 日 志 消 息 提 供 了 唯一 的 ID, 针对 单一 请 求 , 该 ID 在 微服 务 调用 
间 保 持 一 致 。 通 过 使 用 这 一 类 唯一 ID， 可 获取 针对 某 项 事务 生成 的 所 有 日 志 消 息 。 
Twitter 的 Zipkin、Cloudera 的 HTrace 以 及 Google 的 Dapper 均 为 分 布 式 跟踪 系统 的 具 
体 示 例 。 

Spring Cloud Sleuth 包含 了 两 个 核心 概念 ， 即 Span 和 Trace， 其 主要 工作 也 将 围绕 这 
两 个 概念 而 展开 ， 并 针对 这 两 个 概念 创建 DD， 即 Span ID 和 Trace ID. XE, Span 表示 
一 个 基本 的 任务 单元 ， 而 Span ID 则 表示 任务 单元 ， 例 如 对 资源 的 HTTP 调用 。 相 应 地 ， 
Trace 则 表示 一 组 任务 或 一 组 Span, 这 意味 着 Trace ID 表示 为 端 到 端 事务 生成 的 一 组 Span 
ID。 因 此 ， 针 对 茶 项 特定 任务 ， 微 服务 调用 间 的 Trace ID 将 是 相同 的 。 我 们 可 使 用 Trace 
ID 跟踪 病 到 交 的 未 个 调用 ， 如 图 15.10 所 示 。 


Jti 


[Trace-1d-1000,Span-id-1001] | [Trace-id-1000,Span-id-1002] 


微服 务 C 


[Trace-id=1000. [Trace-1d-1000,Span-id-1004] 
Span-id-1003 | 


| ITrace-id-1000,Span-1d-1005 | 


[Trace-1d-1000,Span-1id-1006 | 


图 15.10 


在 图 15.10 中 可 以 看 到 ， 其 中 存在 多 个 微服 务 运行 于 不 同 的 市 点 上 。 因 此 ， 微 服务 A 
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调用 B 和 C， 微 服务 B 调用 D, URS DWH ES. ÆR 15.10 所 示 示 例 中 ，Trace ID 
将 在 所 有 的 微服 务 间 被 传递 ， 并 用 于 跟踪 端 到 端 日 志 事 务 。 
下 面 更 新 之 前 的 Account 和 Customer 微服 务 ， 并 针对 Spring Cloud Sleuth 库 添 加 新 
的 Maven 依赖 项 。 下 列 各 步 又 将 在 分 布 式 应 用 程序 中 利用 Spring Cloud Sleuth 创建 一 个 
不 例 。 
(1) 在 分 布 式 应 用 程序 中 针对 Spring Cloud Sleuth 添加 男 一 个 Maven 依赖 项 ， 如 下 
所 示 : 
<dependency> 
«groupId»org.springframework.cloud«c/groupId» 
x«artifactlId»spring-cloud-starter-sleuth«/artifactlId» 
</dependency> 
(2) Logstash 依赖 关系 与 之 前 实现 集中 日 志 时 采用 的 依赖 项 相同 。 
(3) 通过 在 application.yml 或 bootstrap.yml 中 设置 spring.application.name 属性 ， 进 
而 设置 应 用 程序 名 称 。 另 外 ， 还 可 向 每 个 微服 务 的 Logback 配置 中 添加 该 应 用 程序 名 称 ， 
如 下 所 示 : 


<property name-"spring.application.name" value-"account-service"/» 


<property name= 


该 应 用 程序 名 将 作为 Spring Cloud Sleuth 生成 的 跟踪 结果 的 一 部 分 内 容 加 以 显示 。 
(4) 添加 日 志 消 思 《〈 奋 不 存在 ) ， 确 保 茶 项 服务 可 调用 另 一 项 服务 ， 进 而 在 分 布 式 
应 用 程序 中 检测 日 志 跟 踪 。 此 处 添加 了 一 个 请 求 方 法 ， 以 描述 Trace ID 在 多 项 微服 务 间 
的 传递 过 程 。Customer 服务 中 的 该 方法 将 调用 Account 服务 ， 通 过 RestTemplate ELA: 
位 客户 的 账户 信息 ， 并 在 这 两 个 服务 的 这 些 方法 上 添加 日 志 消 妃 。 


在 CustomerController 类 中 : 


— W 


spring.application.name" value-"customer-service"/» 


aGetMapping (value = "/customer/ícustomerId]") 

public Customer findByAccountId (GPathVariable Integer customerId)|[ 
Custumer cusbomer -~ 

customerRepository.findByCustomerId(customerIld); 
Togger.into("Cusbtomer's account information by calling accountserwice"^); 
hrsbeAGocounbt? list 三 

restTemplate.getForObject ("http://localhost:6060/account/customer/" 
tcustomerlId, List.class, customer); 

customer.setAccount(list); 

logger.info("Find Customer information by id with fetched account 


info: "1icustomerld); 
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return customer; 


} 


在 AccountController 关中 : 


@GetMapping (value = "/account/customer/ícustomer]") 
public List«Account» findByCutomer (@PathbVariable Integer 
customer ) { 

loqger.nfo("Frnd all Accounts information by customer: 
"customer? ; 

return accountRepository.findAllByCustomerId (customer); 


} 
(5) 运行 Customer 和 Account ARI, JF EÙ A s jl] http://localhost:6161/ 
customer/1001 iij zi « 
(6) ÆRES HEREA HTK, HAAN Trace ID 和 Span ID. 
Customer 微服 务 控制 台 日 志 如 下 所 示 : 


2018-05-09 00:51:00.639 INFO [customer-service,9ab5b62435cOfb488a, 
9a562435c0fb488a,false] Customer's account information by calling 
account-service 

2018-05-09 00:51:00.766 INFO [customer-service,9ab5b62435cOfb488a, 
9a562435c0fb488a,false] Find Customer information by id with 
fetched account info: 1001 


可 以 看 到 ，Sleuth XN f [custome-rservice, 9a562435c0fb488a, 9a562435c0fb488a, 
false]。 其 中 , 第 一 部 分 内 容 Ccustomer-service) 表示 应 用 程序 名 ; 第 二 部 分 表示 Trace ID; 
第 三 部 分 表示 SpanID; 最 后 一 部 分 内 容 表示 是 否 应 该 将 Span 导出 到 Zipkin 中 。 

Account 做 服务 控制 合 日 忘 如 下 所 示 : 

2018-05-09 00:51:00.741 INFO [account-service, 9ab562435cOfb488a, 

72a6bb245fccafd9,false] Find all Accounts information by customer: 

1001 

2018-05-09 00:53:38.109 INFO [àaccount-servrceo,, ] Resolving eureka 

endpoints via configuration 

此 处 显示 了 两 项 服务 的 日 志 ， 其 中 ，Trace ID 相同 ， 而 Span ID 则 有 所 不 同 。 

735b. WAE Kibana 仪表 盘 上 显示 相同 的 内 容 ， 如 图 15.11 所 示 。 

上 述 内 容 讨 论 了 了 Sleuth 库 以 存储 日 志 消 息 。 接 下 来 将 讨论 如 何 借助 于 Zipkin 分 析 服 
务 调 用 的 延迟 问题 。 
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* May 93th 2018, 00:51:00. 845 message: i Gtimestamp 3 2018-05-08T19:21:00.766-00:00"," severity : INFO", service : customer-s 
erv1ce", trace : 9a562435cOfb488a , span": 9a562435cOfb4B8Ba , parent" : ", exportable":" fals 
e","pid":"12224", "thread" :"http-n1o-6161-exec-4","class":"c.d.c.controller.CustomerControlle 


r","rest":"Find Customer information by id with fetched account info: 1001"] version: 1 


port: 63,324 host: 127.0.0.1 timestamp: May Sth 2018, 00:51:00.845 id: aOQzQWMBscxditLHJWOc 


^ May Stn 2018, 00:51:00./44 message: Í'"&timestamp' :" 2018-05-08T19:21:00.741«00:00", " severity" :"INFO", "service" :"account-se 
rvice"," trace :"72a6bb245fccafd9", "span" :"72a6bb245fccafd9", "parent" :"","exportable":" false","p 
1d" :"12120"," "thread" :"http-n1o-6060-exec-4","class":"c.d.a. controller.AccountController","res 


t":"Find all Accounts information by customer: 1001" version: 1 port: 63,314 host: 127.0.0. 


1 timestamp: May 9th 2018, 00:51:00.744 id: f-QzQWMBscxdltLHJWOc type: doc index: loastas 


à May 9th 2018, 00:51:00.671 message: { Gtimestamp' :"2018-05-08T19:21:00.639-00:00", "severity": INFO", "service": "customer-s 


ervice","trace":"9a562435cOfb488a" "span" :" 9a552435cOTBABSBa8 , parent": ", "exportable":"fals 


"1: 12224","thread":"http-nio-6161-exec-4","class":"c.d.c. controller.CustomerControlle 
rest"':"Customer's account information by calling account-service "} version: 1 port: 63,3 


24 host: 127.0.0.1 timestamp: May 9th 2018, 00:51:00. 671 id: fuQzQWMBscxdltLHJGlv type: do 


图 15.11 


15.3.3 基于 Zipkin 的 请 求 跟 味 


Spring Cloud 提供 了 与 Zipkin 库 的 集成 方案 。 本 贡 将 讨论 如 何 回 微 服务 应 用 程序 中 添 
加 Zipkin。Zipkin 可 同 应 用 程序 中 加 入 日 志 消 晨 跟 踪 机 制 ,例如 发 送 、 接 收 、 存 储 和 可 视 
化 功能 。 除 此 之 外 ，Zipkin 还 可 在 服务 器 间 跟 中 日 志 活 动 ， 从 而 清晰 地 了 解 应 用 程序 和 
微服 务 中 的 详细 信息 。 

上 述 内 容 兽 讨论 了 Spring Cloud Sleuth， 据 此 ， 可 方便 地 在 分 布 式 应 用 程序 中 跟踪 日 
志 消 息 。 任 何 库 都 可 以 在 日 志 消 息 中 提供 额外 的 信息 ， 这 对 应 用 程序 非常 有 用 。 因此 ， 
我 们 采用 了 ELK， 并 针对 微服 务 采 集 和 分 析 日 志 消 息 ， 同 时 这 也 对 应 用 程序 监视 机 制 十 
分 有 用 。 除 此 之 外 ， 我 们 还 通过 Trace ID 搜索 微服 务 间 的 所 有 日 志 消 筷 ， 进 而 了 解 请 求 
在 微服 务 间 的 传递 方式 。 但 有 些 时 候 ， 我 们 还 需 获 取 日 志 消 息 中 更 为 丰富 的 信息 ， 如 时 
则 信息 ， 并 计算 请 求 在 微服 务 则 的 时 长 。 针 对 这 一 问题 ，Spring Cloud 还 支持 Zipkin Æ, 
开 提 供 卫 Spring Cloud wn Zipkin 模块 。 通 过 在 项 目 中 加 入 Spring-cloud-sleuth-Zipkin 
Maven 依赖 关系 ， 即 可 加 入 该 模块 。 

Spring Cloud Sleuth 将 把 跟踪 信息 发 送 宇 Zipkin 服务 器 。 默 认 状 态 下 ，Zipkin 运行 于 
http://localhost:9411 上 。 当 然 ， 通 过 在 应 用 程序 属性 中 设置 spring.zipkin.baseUrl 属性 ， 还 
可 对 其 进行 和 目 定义 。 下 面 司 用 应 用 程序 ， 并 采用 Spring Cloud Sleuth Zipkin， 进 而 将 跟踪 
信息 上 发送 至 Zipkin 服务 器 。 考 但 下 列 Maven 依赖 关系 : 


«dependency» 
«groupld»org.springframework.cloudc/groupId» 
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«artifactId»spring-cloud-sleuth-zipkin«/artifactId» 

</dependency> 

默认 条 件 下 ， 如 果 将 spring-cloud-starter-zipkin 作为 依赖 关系 添加 全 项 目 中 《〈Span 处 
于 关闭 状态 ) ， 消 息 将 通过 HTTP 发 送 至 Zipkin。 此 时 ， 通 信 处 于 异步 状态 。 通 过 设置 
spring.zipkin.baseUrl 属性 ， 还 可 对 URL 进行 配置 ， 如 下 有 所 示 : 


Sspring.zipkin.baseUrl: http://Iocathost:9411/ 


Be PFoKIRIBUss HP SJ Zipkin His a8, M P7 Maven Zipkin 依赖 关系 ， 可 创建 相应 
的 Zipkin Bk 2$ ds MH FEJT o 
<dependency> 
«groupId»io.zipkin.javac/groupId» 
«artifactId»zipkin-server«/artifactId» 
</dependency> 
<dependency> 
«groupld»io.zipkin.javac/groupId» 
«artifact Td^zipkin-autoconfiqure-uic/artifactTd- 
«scope»runtime«c/scope» 
</dependency> 
上 述 Maven 依赖 关系 设置 了 Zipkin 服务 器 和 Zipkin UI 应 用 程序 ， 但 需要 通过 注解 
对 其 加 以 局 用 。 
这 将 是 一 个 Spring Boot 应 用 程序 , 并 在 main 应 用 程序 类 中 通过 @EnableZipkinServer 
注解 启用 Zipkin 服务 器 ， 如 下 所 示 : 
aSpringBootApplication 
aEnableZipkinServer 
public class ZrpkinServerApplication 1| 


} 

默认 状态 下 ，Zipkin 将 运行 于 http:/localhost:9411 上 。 注 解 @EnableZipkinServer 将 
以 此 监听 传 入 的 Span，http://localhost:9411 UI 则 用 于 查询 。 

但 这 并 不 需要 创建 一 个 Zipkin 服务 如 应 用 程序 ,我 们 可 使 用 内 建 的 Zipkin 应 用 程序 。 
Zipkin 包 含 了 一 个 Docker 镜 像 以 及 该 应 用 程序 的 一 个 可 执行 JAR 包 (位 于 https://zipkin.io/ 
pages/quickstart.html) ， 访 者 可 将 其 下 载 至 机 器 上 ， 并 通过 下 列 命令 对 其 加 以 运行 。 


$ java -jar zipkin-server-2.8.3-exec.jar 


运行 Zipkin 应 用 程序 后 ， 对 应 结果 如 图 15.12 所 示 。 
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j 


Dinesh.Rajput&àMRNDTHTMOBLOOO2 /d 
S | 


Java -Jar zi1pkin-server-2.8.3-exec. ] 


Powered by Spring Boot :: (v2.0.1.RELEASE) 


2018-05-21 19:26:24.520 INFO 11768 --- | main] z.s.Z1pk1inServer 
arted by Dinesh. Rajput 1n D:\) 
2018-05-21 19:26:24.536 INFO 117/768 --- | main| z.s.Z1pk1nServer 


图 15.12 


在 图 15.12 中 可 以 看 到 ，Zipkin 服务 器 已 处 于 启动 状态 ， 在 浏览 器 中 运行 


http://localhost:9411 即 可 对 其 加 以 访问 ， 如 图 15.13 所 示 。 


Zipkin investigate syst a trace View Saved Trace Dependencies 


Service Name Span Name Lookback 


all j 1 hour 


Annotations Query Duration (ps) >= 


Find Traces l!:*, | 
Longest First 


Please select the criteria for your trace lookup 


图 15.13 


不 难 友 现 ，Zipkin UI 可 用 于 获取 Trace 和 Span. 
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在 添加 并 局 用 了 Zipkin 服务 右 后 ， 接 下 来 癌 微 服务 中 添加 Spring Cloud Sleuth Zipkin 
依赖 关系， 如 Account 服务 和 Customer 服务 。 对 此 ， 可 癌 每 个 微服 务 中 加 入 下 列 Maven 
依赖 项 。 

<dependency> 

«groupId»org.springframework.cloudc/groupId» 
«artifactid»spring-cloud-starter-zipkins/artifactid^ 

</dependency> 

E35 Zipkin starter 依赖 项 还 将 包含 Spring Cloud Sleuth JÆ (spring-cloud-starter-sleuth ), 
因而 无 有 顷 单独 对 其 予以 添加 。 

上 述 内 容 曾 介绍 了 Sleuth 工具 ， 该 工具 用 于 生成 Trace ID 和 Span ID; Sleuth 则 用 于 
将 信息 , 如 Trace ID 和 Span ID, 添加 至 数据 头 中 的 服务 调用 中 ,以 便 Zipkin 工具 和 ELK 
可 使 用 这 一 类 信息 。 

至 此 ， 我 们 已 在 微服 务 中 集成 了 Zipkin 和 Sleuth。 因 此 ， 当 调用 客户 服务 端点 时 ， 
Sleuth 将 目 动 处 理 并 将 此 类 服务 调用 信息 发 送 至 所 绑 定 的 Zipkin 服务 器 上 。 同 时 ，Zipkin 
将 计算 服务 调用 延迟 以 及 其 他 信息 。 

Kl 15.14 显示 了 调用 Customer 服务 时 的 状态 。 


Eureka 


几 15.14 


在 图 15.14 中 可 以 看 到 ，Zipkin 将 存储 这 一 延迟 信息 。 在 浏览 器 中 调用 了 Customer 
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服务 后 ， 打 开 Zipkin 仪表 盘 ， 对 应 结果 如 图 15.15 所 示 。 


€ SAN «T. http://localhost:9411/zipkin/?servi JO ~ © < Zipkin - Index 


Service Name Span Name Lookback 


all all F | 1 hour 


Annotations Query Duration (ys) >= 


e.g. "http path-/foo/bar/ and cluster-foo and cache miss" 


Find Traces IE?) | 
Newest First 


showing: 10 of 10 
Services: ED 


8.82Bms 1 spans 
all 0% 


5.454ms  15pans 
all 0% 


default xi 5ms | 


969p 1 spans 
图 15.15 


在 图 15.15 中 可 以 看 到 ， 其 中 包含 了 具有 Span ID 的 服务 调用 的 延迟 信息 。 单 击 仪表 
盘 中 的 Trace ID， 将 显示 与 Trace ID 相关 的 信息 ， 如 图 15.16 所 示 。 


二 -T- http://localhost:3411/zipkin/traces/b4f9b43ae93f6473 P = È| .9 zipkin - Traces 


Duration: Services: ÆÐ Depth: $9 Total Spans: © 


| Expand All | Collapse Al || Filter... v 


default x1 


Services 1./66ms 3.531ms 5.207ms T.062ms 8.828ms 


8.828ms : put 


图 15.16 


其 中 包含 了 与 特定 Trace ID RRES, BREXE BER SX 3.29. Hy. XRupEt—2p 
查看 Trace 的 详细 信息 ， 包 括 全 部 Span ID。 单 击 该 行 后 ， 对 应 结果 如 图 15.17 所 示 。 
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r BU T- http:/localhost9411/zipkin/traces/b4f9b43ae93f6473 Do .9 Zipkin - Traces 


default.put: 8.828ms 
AKA: default 


Date Time Relative Time Annotation Address 
21-05-2018 08:20:44 PM server Receive 192.168.99.1 (default) 


21-05-2018 08:20:44 PM 8.828ms Server Send 192.168.99.1 (default) 


Key Value 
Client Address 12/.0.0 1:58768 
http.method PUT 


http.path leureka/apps/ACCOUNT -SERVICE/MRND THTMOBLOOO02.timesgroup.com:-accounít-service-6060 


traceld b4f9b43ae93f6473 
spanid b4f9b43ae93f6473 


parentld 


图 15.17 


针对 特定 的 微服 务 端 到 端 事务 ， 图 15.17 显示 了 与 Trace ID 相关 的 更 为 丰富 的 信息 。 
综 上 所 述 ， 我 们 希望 读者 能 够 使 用 Zipkin 库 分 析 分 布 式 系统 中 微服 务 间 的 服务 调用 
的 延迟 信息 。 相 应 地 ，Sleuth 将 把 API 调用 信息 传递 至 Zipkin 中 。 


15.4 A x2 


本 章 讨 论 了 监测 微服 务 和 容器 的 重要 性 。 其 间 ， 我 们 创建 了 一 个 集中 日 志方 案 ， 并 
通过 ELK 解决 了 传统 日 志 系 统 中 的 常见 问题 。 

Spring Cloud Sleuth API 提供 了 分 布 式微 服务 应 用 程序 中 事务 的 日 志 跟 躁 机制 和 端 到 
dm HEERE. AIh, Zipkin 提供 了 基于 时 间 戳 的 日 志 跟 踩 技 术 。 因 此 ，Zipkin 库 对 于 分 布 
式 应 用 程序 来 说 十 分 有 用 。 


